<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.4"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Flow-IPC: session/detail/client_session_impl.hpp Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr id="projectrow">
  <td id="projectalign">
   <div id="projectname">Flow-IPC<span id="projectnumber">&#160;2.0.0</span>
   </div>
   <div id="projectbrief">Flow-IPC project: Full implementation reference.</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.4 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search",'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div id="nav-path" class="navpath">
  <ul>
<li class="navelem"><a class="el" href="dir_938858dd290fe54e59e3500689c41d32.html">session</a></li><li class="navelem"><a class="el" href="dir_b920fd4362476866a1b4325a80ed2bf5.html">detail</a></li>  </ul>
</div>
</div><!-- top -->
<div class="header">
  <div class="headertitle"><div class="title">client_session_impl.hpp</div></div>
</div><!--header-->
<div class="contents">
<a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/* Flow-IPC: Sessions</span></div>
<div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"> * Copyright 2023 Akamai Technologies, Inc.</span></div>
<div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment"> *</span></div>
<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment"> * Licensed under the Apache License, Version 2.0 (the</span></div>
<div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"> * &quot;License&quot;); you may not use this file except in</span></div>
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment"> * compliance with the License.  You may obtain a copy</span></div>
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment"> * of the License at</span></div>
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno">    8</span><span class="comment"> *</span></div>
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno">    9</span><span class="comment"> *   https://www.apache.org/licenses/LICENSE-2.0</span></div>
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno">   10</span><span class="comment"> *</span></div>
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno">   11</span><span class="comment"> * Unless required by applicable law or agreed to in</span></div>
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno">   12</span><span class="comment"> * writing, software distributed under the License is</span></div>
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno">   13</span><span class="comment"> * distributed on an &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR</span></div>
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno">   14</span><span class="comment"> * CONDITIONS OF ANY KIND, either express or implied.</span></div>
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno">   15</span><span class="comment"> * See the License for the specific language governing</span></div>
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno">   16</span><span class="comment"> * permissions and limitations under the License. */</span></div>
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno">   17</span><span class="comment"></span> </div>
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno">   18</span><span class="comment">/// @file</span></div>
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno">   19</span><span class="comment"></span><span class="preprocessor">#pragma once</span></div>
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno">   20</span> </div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno">   21</span><span class="preprocessor">#include &quot;<a class="code" href="session__base_8hpp.html">ipc/session/detail/session_base.hpp</a>&quot;</span></div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno">   22</span><span class="preprocessor">#include &quot;<a class="code" href="ipc__session_2src_2ipc_2session_2error_8hpp.html">ipc/session/error.hpp</a>&quot;</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno">   23</span><span class="preprocessor">#include &quot;<a class="code" href="ipc__core_2src_2ipc_2transport_2error_8hpp.html">ipc/transport/error.hpp</a>&quot;</span></div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno">   24</span><span class="preprocessor">#include &quot;<a class="code" href="protocol__negotiator_8hpp.html">ipc/transport/protocol_negotiator.hpp</a>&quot;</span></div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno">   25</span><span class="preprocessor">#include &quot;<a class="code" href="util_8hpp.html">ipc/util/detail/util.hpp</a>&quot;</span></div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno">   26</span><span class="preprocessor">#include &lt;boost/interprocess/sync/named_mutex.hpp&gt;</span></div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno">   27</span><span class="preprocessor">#include &lt;boost/interprocess/sync/scoped_lock.hpp&gt;</span></div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno">   28</span><span class="preprocessor">#include &lt;boost/move/make_unique.hpp&gt;</span></div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno">   29</span><span class="preprocessor">#include &lt;cstddef&gt;</span></div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno">   30</span> </div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno">   31</span><span class="keyword">namespace </span><a class="code hl_namespace" href="namespaceipc_1_1session.html">ipc::session</a></div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno">   32</span>{</div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno">   33</span><span class="comment"></span> </div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno">   34</span><span class="comment">/**</span></div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno">   35</span><span class="comment"> * Internal, non-movable pImpl-lite implementation of Client_session_mv class template.</span></div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno">   36</span><span class="comment"> * In and of itself it would have been directly and publicly usable; however Client_session_mv adds move semantics.</span></div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno">   37</span><span class="comment"> *</span></div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno">   38</span><span class="comment"> * @see All discussion of the public API is in Client_session_mv doc header; that class template forwards to this</span></div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno">   39</span><span class="comment"> *      one.  All discussion of pImpl-lite-related notions is also there.  See that doc header first please.  Then come</span></div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno">   40</span><span class="comment"> *      back here.</span></div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno">   41</span><span class="comment"> *</span></div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno">   42</span><span class="comment"> * Impl design</span></div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno">   43</span><span class="comment"> * -----------</span></div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno">   44</span><span class="comment"> * Thread U represents all threads other than thread W: since the relevant methods are to be called by the user</span></div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno">   45</span><span class="comment"> * sans concurrency, those threads as a collection can be thought of as one thread.</span></div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno">   46</span><span class="comment"> *</span></div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno">   47</span><span class="comment"> * Thread W is the async worker thread where most work is done; this helps us entirely avoid mutexes.</span></div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno">   48</span><span class="comment"> * Both async_connect() (from sync_connect()) and open_channel() are fairly infrequently called, so it&#39;s not necessary</span></div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno">   49</span><span class="comment"> * to avoid latency by doing work concurrently in threads U and W.  So we keep it simple by posting most stuff</span></div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno">   50</span><span class="comment"> * onto thread W.</span></div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno">   51</span><span class="comment"> *</span></div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno">   52</span><span class="comment"> * There are two distinct states (other than NULL): CONNECTING (async_connect() outstanding) and PEER (it succeeded:</span></div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno">   53</span><span class="comment"> * `*this` is now a Session in PEER state per concept).  (As of this writing async_connect() is `private` and</span></div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno">   54</span><span class="comment"> * invoked by `public` sync_connect(); more on that jsut below.)</span></div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno">   55</span><span class="comment"> *</span></div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno">   56</span><span class="comment"> * ### CONNECTING state impl ###</span></div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno">   57</span><span class="comment"> * Once async_connect() is issued we must do the following:</span></div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno">   58</span><span class="comment"> *   -# Synchronously find out the full `Shared_name` where the opposing Session_server is allegedly listening,</span></div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno">   59</span><span class="comment"> *      which is computable by a #Base helper.  So that it can be computed we need to find out</span></div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno">   60</span><span class="comment"> *      Session_base::srv_namespace() which we immediately do by checking the expected file that should have been</span></div>
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno">   61</span><span class="comment"> *      written by Session_server.</span></div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno">   62</span><span class="comment"> *   -# Issue the Native_socket_stream::sync_connect() which shall synchronously/non-blockingly connect to that</span></div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno">   63</span><span class="comment"> *      abstract-address.</span></div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno">   64</span><span class="comment"> *   -# Once that&#39;s done, go back to NULL on failure; or continue as follows on success: The Native_socket_stream,</span></div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno">   65</span><span class="comment"> *      now in PEER state (connected), is upgraded to (wrapped by) a transport::Channel which is in turn upgraded to</span></div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno">   66</span><span class="comment"> *      a transport::struc::Channel Client_session_impl::m_master_channel.</span></div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno">   67</span><span class="comment"> *      This is the session master channel, in log-in phase (as client)</span></div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno">   68</span><span class="comment"> *      (details of that API are in transport::struc::Channel docs).  So we immediately issue the next</span></div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno">   69</span><span class="comment"> *      async step: sending the log-in request over `m_master_channel` and async-await log-in response.</span></div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno">   70</span><span class="comment"> *   -# Once that&#39;s done, go back to NULL on failure; or else yay: we&#39;re now in PEER state...</span></div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno">   71</span><span class="comment"> *   -# ...almost.  If the advanced form of sync_connect() was the one invoked, there&#39;s an additional exchange of</span></div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno">   72</span><span class="comment"> *      info about init-channels, wherein the opposing Session_server sends us info about the pre-opened init-channels.</span></div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno">   73</span><span class="comment"> *      If so, PEER state is reached upon receipt of this; otherwise immediately.</span></div>
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno">   74</span><span class="comment"> *</span></div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno">   75</span><span class="comment"> * See session_master_channel.capnp for the schema for `m_master_channel`.  Reading that gives a nice overview of</span></div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno">   76</span><span class="comment"> * the protocol involved, both in CONNECTING (after the socket is connected) and in PEER.  Also notable is that</span></div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno">   77</span><span class="comment"> * this setup allows us to immediately &quot;eat our own dog food&quot; by using a `struc::Channel` to enable the opening</span></div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno">   78</span><span class="comment"> * of any further channels (structured or otherwise).</span></div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno">   79</span><span class="comment"> *</span></div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno">   80</span><span class="comment"> * ### CONNECTING state and asynchronicity ###</span></div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno">   81</span><span class="comment"> * As written, sync_connect() -- as a black box -- is synchronous and non-blocking.  It is written trivially</span></div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno">   82</span><span class="comment"> * as invoking async_connect() (which is `private`); giving it a simple completion handler that fulfills a</span></div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno">   83</span><span class="comment"> * `promise`; sync_connect() awaits this fulfillment in the user&#39;s calling thread and then returns.  This raises</span></div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a7c3b6df1a8dab3a2c31b3ad492aa5d8a">   84</a></span><span class="comment"> * two key questions.</span></div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno">   85</span><span class="comment"> *</span></div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno">   86</span><span class="comment"> * One, how is this even possible -- if there&#39;s (even internally) an async step, how can sync_connect() be</span></div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno">   87</span><span class="comment"> * synchronous yet non-blocking?  Answer: First we quote the Client_session_mv public doc header which explains</span></div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno">   88</span><span class="comment"> * why there is only `sync_connect()` but no `async_connect()`:</span></div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno">   89</span><span class="comment"> * &quot;Without networking, the other side (Session_server) either exists/is listening; or no.</span></div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno">   90</span><span class="comment"> * Connecting is a synchronous, non-blocking operation; so an `async_connect()` API in this context only makes</span></div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno">   91</span><span class="comment"> * life harder for the user.  (However, there are some serious plans to add a networking-capable counterpart</span></div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno">   92</span><span class="comment"> * (probably via TCP at least) to `Native_socket_stream` and therefore Client_session_mv; such a networky-client-session</span></div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno">   93</span><span class="comment"> * class will almost certainly have an `async_connect()`, while its `sync_connect()` will probably become potentially</span></div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno">   94</span><span class="comment"> * blocking.)&quot;  So that is why it works: in a local setting, the socket-connect is synchronous/fast; and upon</span></div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno">   95</span><span class="comment"> * connecting the necessary log-in/init-channel exchange is also quick.</span></div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno">   96</span><span class="comment"> *</span></div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno">   97</span><span class="comment"> * Two: Why is it written like this?  Wouldn&#39;t the internal code be simpler, if it lacked asynchronicity?</span></div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno">   98</span><span class="comment"> * The answer is two-fold:</span></div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno">   99</span><span class="comment"> *   - The mundane reason as of this writing is there is no transport::struc::Channel `sync_expect_msgs()`,</span></div>
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno">  100</span><span class="comment"> *     a hypothetical method that&#39;d await N incoming messages.  That&#39;s a to-do maybe: provide</span></div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno">  101</span><span class="comment"> *     `sync_expect_msg[s]()` which would be to `expect_msg[s]()` what `sync_request()` is to `async_request()`.</span></div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno">  102</span><span class="comment"> *     Then the init-channel phase can be written in synchronous form.</span></div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno">  103</span><span class="comment"> *     - That said, the other steps listed above are already writable in synchronous form:</span></div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno">  104</span><span class="comment"> *       transport::Native_socket_stream::sync_connect() we already use; the log-in `.async_request()` can be</span></div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno">  105</span><span class="comment"> *       trivially replaced with `.sync_request()`.</span></div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno">  106</span><span class="comment"> *   - But the true, deeper reason has to do with the above public-facing quote: When/if we network-enable</span></div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno">  107</span><span class="comment"> *     some form of `*this`, all 2-3 quick/synchronous steps described will potentially block; and we&#39;ll need</span></div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno">  108</span><span class="comment"> *     to make async_connect() a public API.  At that point writing sync_connect() in terms of async_connect()</span></div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno">  109</span><span class="comment"> *     will pay dividends.  The trade-off is the existing code is somewhat more complex in the meantime.</span></div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno">  110</span><span class="comment"> *     - Detail: Since there is no public `Native_socket_stream::async_connect()` (as it, too, is not network-enabled),</span></div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno">  111</span><span class="comment"> *       we do use the simpler-to-use `Native_socket_stream::sync_connect()`.  Once network-enabled, that guy</span></div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno">  112</span><span class="comment"> *       will become potentially blocking; so we&#39;d need to start using the speculated public-API `async_connect()`.</span></div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno">  113</span><span class="comment"> *</span></div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno">  114</span><span class="comment"> * A related aspect is that `on_done_func` completion handler we pass to async_connect() currently *will* fire</span></div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno">  115</span><span class="comment"> * before sync_connect() returns; so there&#39;s no contract for the dtor to fire it with operation-aborted error code,</span></div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno">  116</span><span class="comment"> * and we can just `assert()` on this in dtor and not worry about it further.  Yet if async_connect() becomes public,</span></div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno">  117</span><span class="comment"> * then there&#39;s no longer that guarantee, and we&#39;ll need to fire it as needed from dtor.</span></div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno">  118</span><span class="comment"> *</span></div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno">  119</span><span class="comment"> * In the code itself we sometimes refer to the above discussion to hopefully make maintenance/future development</span></div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno">  120</span><span class="comment"> * easier.</span></div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno">  121</span><span class="comment"> *</span></div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno">  122</span><span class="comment"> * @note If some form of `*this` becomes network-enabled, open_channel() too will need an async form most likely,</span></div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno">  123</span><span class="comment"> *       while existing open_channel() would become potentially-blocking.</span></div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno">  124</span><span class="comment"> *</span></div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno">  125</span><span class="comment"> * ### Protocol negotiation ###</span></div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno">  126</span><span class="comment"> * First please see transport::struc::sync_io::Channel doc header section of the same name.  (There is involved</span></div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno">  127</span><span class="comment"> * discussion there which we definitely don&#39;t want to repeat.)  Then come back here.</span></div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno">  128</span><span class="comment"> *</span></div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno">  129</span><span class="comment"> * How we&#39;re similar: `Channel` decided to divide the protocols into 2: one in struc::sync_io::Channel code itself,</span></div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno">  130</span><span class="comment"> * and the rest in whatever extra stuff might be involved in the (likely SHM-related, optionally used)</span></div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno">  131</span><span class="comment"> * non-vanilla transport::struc::Struct_builder and transport::struc::Struct_reader concept impls (namely</span></div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno">  132</span><span class="comment"> * most likely transport::struc::shm::Builder and transport::struc::shm::Reader).  So essentially there&#39;s the</span></div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno">  133</span><span class="comment"> * `ipc_transport_structured` part, and the (other) part (likely but not necessarily from `ipc_shm`).  We do</span></div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno">  134</span><span class="comment"> * something vaguely similar conceptually:</span></div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno">  135</span><span class="comment"> *   - There is the basic ipc::session protocol, including the `LogInReq/LogInRsp/OpenChannel*` messages.  This</span></div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno">  136</span><span class="comment"> *     is from ipc::session proper (`ipc_session` module/library).</span></div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno">  137</span><span class="comment"> *   - There is the optionally-used protocol woven into it activated by the fact the user chose to use</span></div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno">  138</span><span class="comment"> *     ipc::session::shm (or maybe even their own) `Session` hierarchy.  (As of this writing, ipc::session::shm</span></div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno">  139</span><span class="comment"> *     contains two hierarchies, depending on the SHM-provider of choice: SHM-classic `shm::classic` or</span></div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno">  140</span><span class="comment"> *     SHM-jemalloc `shm::arena_lend::jemalloc`.)</span></div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno">  141</span><span class="comment"> *</span></div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno">  142</span><span class="comment"> * So we, too, maintain two `Protocol_negotiator`s: the main one and the &quot;aux&quot; one for those two bullet points</span></div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno">  143</span><span class="comment"> * respectively.  As of this writing there is only version 1 of everything; but if this changes for one of the</span></div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno">  144</span><span class="comment"> * &quot;aux&quot; `Session` hierarchies -- e.g., SHM-jemalloc&#39;s internally used ipc_session_message.capnp channel/schema --</span></div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno">  145</span><span class="comment"> * then that guy&#39;s &quot;aux&quot; protocol-version can be bumped up.  (In the case of ipc_session_message.capnp specifically,</span></div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno">  146</span><span class="comment"> * and I say this only for exposition, that code can -- if it wants -- do its own protocol negotiation along its</span></div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno">  147</span><span class="comment"> * own channel; but by leveraging the &quot;aux&quot; `Protocol_negotiator` version infrastructure, they do not have to.</span></div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno">  148</span><span class="comment"> * Good for perf and, in this case more importantly, good for keeping code complexity down.)</span></div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno">  149</span><span class="comment"> *</span></div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno">  150</span><span class="comment"> * How we&#39;re different: The mechanics of protocol-version exchange are simpler for us, because we have a built-in</span></div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno">  151</span><span class="comment"> * SYN/SYN-ACK like exchange at the start (log-in-request, log-in-response) via the session master channel.</span></div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno">  152</span><span class="comment"> * So we piggy-back (piggy-front?) the protocol-negotiation info onto those 2 messages which exist anyway.</span></div>
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno">  153</span><span class="comment"> * You can see that now by looking at session_master_channel.capnp and noting how `ProtocolNegotiation` fields</span></div>
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno">  154</span><span class="comment"> * sit up-top in `LogInReq` and `LogInRsp`.  As Protocol_version doc header discussion suggests, it is important</span></div>
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno">  155</span><span class="comment"> * to verify the `ProtocolNegotiation` fields before interpreting any other part of the incoming `LogInReq` and</span></div>
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno">  156</span><span class="comment"> * `LogInRsp` by server and client respectively (and in that chronological order, as guaranteed by the handshake</span></div>
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno">  157</span><span class="comment"> * setup).</span></div>
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno">  158</span><span class="comment"> *</span></div>
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno">  159</span><span class="comment"> * (In contrast to this: struc::sync_io::Channel does not itself have a mandatory built-in handshake phase.  Hence</span></div>
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno">  160</span><span class="comment"> * each side has to send a special `ProtocolNegotiation` message ASAP and expect one -- in each pipe of up-to-2 --</span></div>
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno">  161</span><span class="comment"> * to come in as well.  No handshake/client/server =&gt; the two exchanges are full-duplex, that is mutually</span></div>
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno">  162</span><span class="comment"> * independent, in nature.)</span></div>
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno">  163</span><span class="comment"> *</span></div>
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno">  164</span><span class="comment"> * If you&#39;re keeping score: as of this writing, the most complex/full-featured setup for a session is</span></div>
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno">  165</span><span class="comment"> * the SHM-jemalloc session setup.  Excluding any structured channels opened within the session, the following</span></div>
<div class="line"><a id="l00166" name="l00166"></a><span class="lineno">  166</span><span class="comment"> * transport::Protocol_negotiator negotiations shall occur:</span></div>
<div class="line"><a id="l00167" name="l00167"></a><span class="lineno">  167</span><span class="comment"> *   - Session master channel `Native_socket_stream` low-level protocol (1 `Protocol_negotiator` per side).</span></div>
<div class="line"><a id="l00168" name="l00168"></a><span class="lineno">  168</span><span class="comment"> *     Full-duplex exchange.</span></div>
<div class="line"><a id="l00169" name="l00169"></a><span class="lineno">  169</span><span class="comment"> *   - Session master channel `struc::Channel` protocol (2 `Protocol_negotiator`s per side, &quot;aux&quot; one unused</span></div>
<div class="line"><a id="l00170" name="l00170"></a><span class="lineno">  170</span><span class="comment"> *     because the session master channel is a vanilla, non-SHM-backed channel).</span></div>
<div class="line"><a id="l00171" name="l00171"></a><span class="lineno">  171</span><span class="comment"> *     Full-duplex exchange.</span></div>
<div class="line"><a id="l00172" name="l00172"></a><span class="lineno">  172</span><span class="comment"> *   - Session master channel vanilla session protocol (1 `Protocol_negotiator` per side).</span></div>
<div class="line"><a id="l00173" name="l00173"></a><span class="lineno">  173</span><span class="comment"> *     Handshake exchange.</span></div>
<div class="line"><a id="l00174" name="l00174"></a><span class="lineno">  174</span><span class="comment"> *   - Session master channel SHM-jemalloc session protocol (1 `Protocol_negotiator` per side).</span></div>
<div class="line"><a id="l00175" name="l00175"></a><span class="lineno">  175</span><span class="comment"> *     Handshake exchange (same one as in the previous bullet point).</span></div>
<div class="line"><a id="l00176" name="l00176"></a><span class="lineno">  176</span><span class="comment"> *</span></div>
<div class="line"><a id="l00177" name="l00177"></a><span class="lineno">  177</span><span class="comment"> * Unrelated to sessions, consider the most complex/full-featured setup for a user `transport::struc::Channel` operating</span></div>
<div class="line"><a id="l00178" name="l00178"></a><span class="lineno">  178</span><span class="comment"> * over a 2-pipe `transport::Channel` (1 pipe for blobs, 1 pipe for `Native_handle`s):</span></div>
<div class="line"><a id="l00179" name="l00179"></a><span class="lineno">  179</span><span class="comment"> *   - User channel `Native_socket_stream` low-level protocol (1 `Protocol_negotiator` per side).</span></div>
<div class="line"><a id="l00180" name="l00180"></a><span class="lineno">  180</span><span class="comment"> *     Full-duplex exchange (pipe 1).</span></div>
<div class="line"><a id="l00181" name="l00181"></a><span class="lineno">  181</span><span class="comment"> *   - User channel `Blob_stream_mq_*er` low-level protocol (1 `Protocol_negotiator` per side).</span></div>
<div class="line"><a id="l00182" name="l00182"></a><span class="lineno">  182</span><span class="comment"> *     Full-duplex exchange (pipe 2, same layer as preceding bullet point, different transport type).</span></div>
<div class="line"><a id="l00183" name="l00183"></a><span class="lineno">  183</span><span class="comment"> *   - Session master channel `struc::Channel` protocol (2 `Protocol_negotiator`s per side; main one for the vanilla</span></div>
<div class="line"><a id="l00184" name="l00184"></a><span class="lineno">  184</span><span class="comment"> *     layer, &quot;aux&quot; one for the SHM layer).</span></div>
<div class="line"><a id="l00185" name="l00185"></a><span class="lineno">  185</span><span class="comment"> *     Full-duplex exchange.</span></div>
<div class="line"><a id="l00186" name="l00186"></a><span class="lineno">  186</span><span class="comment"> *</span></div>
<div class="line"><a id="l00187" name="l00187"></a><span class="lineno">  187</span><span class="comment"> * ### PEER state impl ###</span></div>
<div class="line"><a id="l00188" name="l00188"></a><span class="lineno">  188</span><span class="comment"> * Here our algorithm is complementary to the PEER state algorithm in Server_session_impl.  Namely we expect</span></div>
<div class="line"><a id="l00189" name="l00189"></a><span class="lineno">  189</span><span class="comment"> * passive-opens via an appropriate transport::struc::Channel::expect_msgs(); and we allow active-opens via</span></div>
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno">  190</span><span class="comment"> * open_channel().  The details of how these work is best understood just by reading that code inline.</span></div>
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno">  191</span><span class="comment"> *</span></div>
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno">  192</span><span class="comment"> * open_channel(), similarly to Server_session_impl::open_channel(), has one interesting quirk which is:</span></div>
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno">  193</span><span class="comment"> * To the user it is presented as synchronous and blocking with the aim of being non-blockingly fast, as long</span></div>
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno">  194</span><span class="comment"> * as the other side is in PEER state.  It uses transport::struc::Channel::sync_request() with a generous timeout, while</span></div>
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno">  195</span><span class="comment"> * knowing that if both sides in PEER state in practice the call will complete rather swiftly; the generous</span></div>
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno">  196</span><span class="comment"> * timeout aimed making it clear that open_channel() is failing *not* due to some overly tight internal timeout</span></div>
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno">  197</span><span class="comment"> * but more likely due to some application problem such as not calling Server_session::init_handlers() quickly</span></div>
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno">  198</span><span class="comment"> * enough.</span></div>
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno">  199</span><span class="comment"> *</span></div>
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno">  200</span><span class="comment"> * Once PEER state is reached, the Session-concept error emission semantics come into play.  See its doc header.</span></div>
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno">  201</span><span class="comment"> *</span></div>
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno">  202</span><span class="comment"> * @tparam S_MQ_TYPE_OR_NONE</span></div>
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno">  203</span><span class="comment"> *         See #Client_session counterpart.</span></div>
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno">  204</span><span class="comment"> * @tparam S_TRANSMIT_NATIVE_HANDLES</span></div>
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno">  205</span><span class="comment"> *         See #Client_session counterpart.</span></div>
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno">  206</span><span class="comment"> * @tparam Mdt_payload</span></div>
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno">  207</span><span class="comment"> *         See #Client_session counterpart.</span></div>
<div class="line"><a id="l00208" name="l00208"></a><span class="lineno">  208</span><span class="comment"> * @tparam S_SHM_TYPE_OR_NONE</span></div>
<div class="line"><a id="l00209" name="l00209"></a><span class="lineno">  209</span><span class="comment"> *         Identical to opposing Server_session_impl counterpart.</span></div>
<div class="line"><a id="l00210" name="l00210"></a><span class="lineno">  210</span><span class="comment"> * @tparam S_GRACEFUL_FINISH_REQUIRED_V</span></div>
<div class="line"><a id="l00211" name="l00211"></a><span class="lineno">  211</span><span class="comment"> *         `true` if and only if Session_base::Graceful_finisher must be used.</span></div>
<div class="line"><a id="l00212" name="l00212"></a><span class="lineno">  212</span><span class="comment"> *         See its doc header for explanation when that would be the case.</span></div>
<div class="line"><a id="l00213" name="l00213"></a><span class="lineno">  213</span><span class="comment"> */</span></div>
<div class="line"><a id="l00214" name="l00214"></a><span class="lineno">  214</span><span class="keyword">template</span>&lt;schema::MqType S_MQ_TYPE_OR_NONE, <span class="keywordtype">bool</span> S_TRANSMIT_NATIVE_HANDLES,</div>
<div class="line"><a id="l00215" name="l00215"></a><span class="lineno">  215</span>         <span class="keyword">typename</span> Mdt_payload,</div>
<div class="line"><a id="l00216" name="l00216"></a><span class="lineno">  216</span>         schema::ShmType S_SHM_TYPE_OR_NONE, <span class="keywordtype">bool</span> S_GRACEFUL_FINISH_REQUIRED_V&gt;</div>
<div class="line"><a id="l00217" name="l00217"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html">  217</a></span><span class="keyword">class </span><a class="code hl_class" href="classipc_1_1session_1_1Client__session__impl.html">Client_session_impl</a> :</div>
<div class="line"><a id="l00218" name="l00218"></a><span class="lineno">  218</span>  <span class="keyword">public</span> <a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Session_base</a>&lt;S_MQ_TYPE_OR_NONE, S_TRANSMIT_NATIVE_HANDLES, Mdt_payload&gt;,</div>
<div class="line"><a id="l00219" name="l00219"></a><span class="lineno">  219</span>  <span class="keyword">public</span> flow::log::Log_context</div>
<div class="line"><a id="l00220" name="l00220"></a><span class="lineno">  220</span>{</div>
<div class="line"><a id="l00221" name="l00221"></a><span class="lineno">  221</span><span class="keyword">public</span>:</div>
<div class="line"><a id="l00222" name="l00222"></a><span class="lineno">  222</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00223" name="l00223"></a><span class="lineno">  223</span><span class="comment"></span> </div>
<div class="line"><a id="l00224" name="l00224"></a><span class="lineno">  224</span><span class="comment">  /// Short-hand for base type.</span></div>
<div class="line"><a id="l00225" name="l00225"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#acd9519f313206fdd2cd6ca91efb79516">  225</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Base</a> = <a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Session_base&lt;S_MQ_TYPE_OR_NONE, S_TRANSMIT_NATIVE_HANDLES, Mdt_payload&gt;</a>;</div>
<div class="line"><a id="l00226" name="l00226"></a><span class="lineno">  226</span><span class="comment"></span> </div>
<div class="line"><a id="l00227" name="l00227"></a><span class="lineno">  227</span><span class="comment">  /// Short-hand for Session_base super-class.</span></div>
<div class="line"><a id="l00228" name="l00228"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a7d1a81d91f59edf7fd3f5ea104294a7c">  228</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Session_base_obj</a> = <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#acd9519f313206fdd2cd6ca91efb79516">Base</a>;</div>
<div class="line"><a id="l00229" name="l00229"></a><span class="lineno">  229</span><span class="comment"></span> </div>
<div class="line"><a id="l00230" name="l00230"></a><span class="lineno">  230</span><span class="comment">  /// See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00231" name="l00231"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">  231</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">Base::Channel_obj</a>;</div>
<div class="line"><a id="l00232" name="l00232"></a><span class="lineno">  232</span><span class="comment"></span> </div>
<div class="line"><a id="l00233" name="l00233"></a><span class="lineno">  233</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00234" name="l00234"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">  234</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Base::Channels</a>;</div>
<div class="line"><a id="l00235" name="l00235"></a><span class="lineno">  235</span><span class="comment"></span> </div>
<div class="line"><a id="l00236" name="l00236"></a><span class="lineno">  236</span><span class="comment">  /// See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00237" name="l00237"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ae457d7b16843699006feb43e1073296a">  237</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ae457d7b16843699006feb43e1073296a">Mdt_payload_obj</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a35234981ca87cc2f6b118b3e52452ea8">Base::Mdt_payload_obj</a>;</div>
<div class="line"><a id="l00238" name="l00238"></a><span class="lineno">  238</span><span class="comment"></span> </div>
<div class="line"><a id="l00239" name="l00239"></a><span class="lineno">  239</span><span class="comment">  /// See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00240" name="l00240"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">  240</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">Base::Mdt_reader_ptr</a>;</div>
<div class="line"><a id="l00241" name="l00241"></a><span class="lineno">  241</span><span class="comment"></span> </div>
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno">  242</span><span class="comment">  /// See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ad5a3539f5e10933ff4abc7cde1056798">  243</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad5a3539f5e10933ff4abc7cde1056798">Mdt_builder</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a7d68bbb8c0c09983619d563bca30bd45">Base::Mdt_builder</a>;</div>
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno">  244</span><span class="comment"></span> </div>
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno">  245</span><span class="comment">  /// See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a9d93e6080abf3b0827b97e084f5e8356">  246</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a9d93e6080abf3b0827b97e084f5e8356">Mdt_builder_ptr</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">Base::Mdt_builder_ptr</a>;</div>
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno">  247</span><span class="comment"></span> </div>
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno">  248</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a95c690ae89ac5e4017dd2ac030703dae">  249</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a95c690ae89ac5e4017dd2ac030703dae">Structured_msg_builder_config</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#aee0db48505c84d3553b7110a9a815036">Base::Structured_msg_builder_config</a>;</div>
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno">  250</span><span class="comment"></span> </div>
<div class="line"><a id="l00251" name="l00251"></a><span class="lineno">  251</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00252" name="l00252"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ae82914b6c13a8ff1b8ad9b2b179d4d74">  252</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ae82914b6c13a8ff1b8ad9b2b179d4d74">Structured_msg_reader_config</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#abd854f2b9316361ef18f15610c242d4b">Base::Structured_msg_reader_config</a>;</div>
<div class="line"><a id="l00253" name="l00253"></a><span class="lineno">  253</span> </div>
<div class="line"><a id="l00254" name="l00254"></a><span class="lineno">  254</span>  <span class="comment">// Constants.</span></div>
<div class="line"><a id="l00255" name="l00255"></a><span class="lineno">  255</span> </div>
<div class="line"><a id="l00256" name="l00256"></a><span class="lineno">  256</span>  <span class="keyword">static_assert</span>(S_SHM_TYPE_OR_NONE != schema::ShmType::END_SENTINEL,</div>
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno">  257</span>                <span class="stringliteral">&quot;Do not set it to sentinel enum value which is only for counting # of possible values and such.&quot;</span>);</div>
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno">  258</span><span class="comment"></span> </div>
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno">  259</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a1b34618ce1160871a4b16f4ecc3e86e6">  260</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> schema::ShmType <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a1b34618ce1160871a4b16f4ecc3e86e6">S_SHM_TYPE</a> = S_SHM_TYPE_OR_NONE;</div>
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno">  261</span><span class="comment"></span> </div>
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno">  262</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a20f1ea81df379ff8153ba14f56b7f035">  263</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">bool</span> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a20f1ea81df379ff8153ba14f56b7f035">S_SHM_ENABLED</a> = <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a1b34618ce1160871a4b16f4ecc3e86e6">S_SHM_TYPE</a> != schema::ShmType::NONE;</div>
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno">  264</span><span class="comment"></span> </div>
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno">  265</span><span class="comment">  /// See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a4036fbd01410a9befc7c541368d92704">  266</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">bool</span> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a4036fbd01410a9befc7c541368d92704">S_MQS_ENABLED</a> = <a class="code hl_variable" href="classipc_1_1session_1_1Session__base.html#a27a5731a648effb6b4b42f0312affa74">Base::S_MQS_ENABLED</a>;</div>
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno">  267</span><span class="comment"></span> </div>
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno">  268</span><span class="comment">  /// See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ac28652995339005a7afeb467b33b3b62">  269</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">bool</span> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#ac28652995339005a7afeb467b33b3b62">S_SOCKET_STREAM_ENABLED</a> = <a class="code hl_variable" href="classipc_1_1session_1_1Session__base.html#a1f7c4243c8bd55930f51a568884c8aaf">Base::S_SOCKET_STREAM_ENABLED</a>;</div>
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno">  270</span><span class="comment"></span> </div>
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno">  271</span><span class="comment">  /// Short-hand for template parameter knob `S_GRACEFUL_FINISH_REQUIRED_V`: see class template doc header.</span></div>
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a65fe6d3d227016858428a170db961cc7">  272</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">bool</span> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a65fe6d3d227016858428a170db961cc7">S_GRACEFUL_FINISH_REQUIRED</a> = S_GRACEFUL_FINISH_REQUIRED_V;</div>
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno">  273</span> </div>
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno">  274</span>  <span class="comment">// Constructors/destructor.</span></div>
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno">  275</span><span class="comment"></span> </div>
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno">  276</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno">  277</span><span class="comment">   * See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno">  278</span><span class="comment">   *</span></div>
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno">  279</span><span class="comment">   * @param logger_ptr</span></div>
<div class="line"><a id="l00280" name="l00280"></a><span class="lineno">  280</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno">  281</span><span class="comment">   * @param cli_app_ref</span></div>
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno">  282</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno">  283</span><span class="comment">   * @param srv_app_ref</span></div>
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno">  284</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno">  285</span><span class="comment">   * @param on_err_func</span></div>
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno">  286</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno">  287</span><span class="comment">   * @param on_passive_open_channel_func</span></div>
<div class="line"><a id="l00288" name="l00288"></a><span class="lineno">  288</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00289" name="l00289"></a><span class="lineno">  289</span><span class="comment">   */</span></div>
<div class="line"><a id="l00290" name="l00290"></a><span class="lineno">  290</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> On_passive_open_channel_handler, <span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l00291" name="l00291"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a8fe80ed65e416a2d1fcadb045dac0fcf">  291</a></span>  <span class="keyword">explicit</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a8fe80ed65e416a2d1fcadb045dac0fcf">Client_session_impl</a>(flow::log::Logger* logger_ptr,</div>
<div class="line"><a id="l00292" name="l00292"></a><span class="lineno">  292</span>                               <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>&amp; cli_app_ref, <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__app.html">Server_app</a>&amp; srv_app_ref,</div>
<div class="line"><a id="l00293" name="l00293"></a><span class="lineno">  293</span>                               Task_err&amp;&amp; on_err_func,</div>
<div class="line"><a id="l00294" name="l00294"></a><span class="lineno">  294</span>                               On_passive_open_channel_handler&amp;&amp; on_passive_open_channel_func);</div>
<div class="line"><a id="l00295" name="l00295"></a><span class="lineno">  295</span><span class="comment"></span> </div>
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno">  296</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno">  297</span><span class="comment">   * See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno">  298</span><span class="comment">   *</span></div>
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno">  299</span><span class="comment">   * @param logger_ptr</span></div>
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno">  300</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno">  301</span><span class="comment">   * @param cli_app_ref</span></div>
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno">  302</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno">  303</span><span class="comment">   * @param srv_app_ref</span></div>
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno">  304</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno">  305</span><span class="comment">   * @param on_err_func</span></div>
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno">  306</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno">  307</span><span class="comment">   */</span></div>
<div class="line"><a id="l00308" name="l00308"></a><span class="lineno">  308</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l00309" name="l00309"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a0edcc39889b5f68492eb9156dc7a9b7a">  309</a></span>  <span class="keyword">explicit</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a0edcc39889b5f68492eb9156dc7a9b7a">Client_session_impl</a>(flow::log::Logger* logger_ptr,</div>
<div class="line"><a id="l00310" name="l00310"></a><span class="lineno">  310</span>                               <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>&amp; cli_app_ref, <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__app.html">Server_app</a>&amp; srv_app_ref,</div>
<div class="line"><a id="l00311" name="l00311"></a><span class="lineno">  311</span>                               Task_err&amp;&amp; on_err_func);</div>
<div class="line"><a id="l00312" name="l00312"></a><span class="lineno">  312</span><span class="comment"></span> </div>
<div class="line"><a id="l00313" name="l00313"></a><span class="lineno">  313</span><span class="comment">  /// See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00314" name="l00314"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aa12539a1a446cffb097f70cba8166088">  314</a></span><span class="comment"></span>  <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#aa12539a1a446cffb097f70cba8166088">~Client_session_impl</a>();</div>
<div class="line"><a id="l00315" name="l00315"></a><span class="lineno">  315</span> </div>
<div class="line"><a id="l00316" name="l00316"></a><span class="lineno">  316</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l00317" name="l00317"></a><span class="lineno">  317</span><span class="comment"></span> </div>
<div class="line"><a id="l00318" name="l00318"></a><span class="lineno">  318</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00319" name="l00319"></a><span class="lineno">  319</span><span class="comment">   * See Client_session_mv counterpart.  Reminder: it can be used not only in PEER state (for open_channel()) but</span></div>
<div class="line"><a id="l00320" name="l00320"></a><span class="lineno">  320</span><span class="comment">   * also NULL state (for async_connect()).</span></div>
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno">  321</span><span class="comment">   *</span></div>
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno">  322</span><span class="comment">   * @return See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno">  323</span><span class="comment">   */</span></div>
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a7ecad909e1013271ff365437f2fdae85">  324</a></span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">Mdt_builder_ptr</a> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a7ecad909e1013271ff365437f2fdae85">mdt_builder</a>() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno">  325</span><span class="comment"></span> </div>
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno">  326</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno">  327</span><span class="comment">   * See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00328" name="l00328"></a><span class="lineno">  328</span><span class="comment">   *</span></div>
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno">  329</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00330" name="l00330"></a><span class="lineno">  330</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno">  331</span><span class="comment">   * @return See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno">  332</span><span class="comment">   */</span></div>
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aaf622f5f111ffa95d4ec6c636cfddb4a">  333</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#aaf622f5f111ffa95d4ec6c636cfddb4a">sync_connect</a>(<a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code);</div>
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno">  334</span><span class="comment"></span> </div>
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno">  335</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno">  336</span><span class="comment">   * See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno">  337</span><span class="comment">   *</span></div>
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno">  338</span><span class="comment">   * @param mdt</span></div>
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno">  339</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno">  340</span><span class="comment">   * @param init_channels_by_cli_req_pre_sized</span></div>
<div class="line"><a id="l00341" name="l00341"></a><span class="lineno">  341</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00342" name="l00342"></a><span class="lineno">  342</span><span class="comment">   * @param mdt_from_srv_or_null</span></div>
<div class="line"><a id="l00343" name="l00343"></a><span class="lineno">  343</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00344" name="l00344"></a><span class="lineno">  344</span><span class="comment">   * @param init_channels_by_srv_req</span></div>
<div class="line"><a id="l00345" name="l00345"></a><span class="lineno">  345</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00346" name="l00346"></a><span class="lineno">  346</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00347" name="l00347"></a><span class="lineno">  347</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00348" name="l00348"></a><span class="lineno">  348</span><span class="comment">   * @return See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00349" name="l00349"></a><span class="lineno">  349</span><span class="comment">   */</span></div>
<div class="line"><a id="l00350" name="l00350"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aa60d7f50f9a9bec95c627778f1556be0">  350</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#aa60d7f50f9a9bec95c627778f1556be0">sync_connect</a>(<span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">Mdt_builder_ptr</a>&amp; mdt,</div>
<div class="line"><a id="l00351" name="l00351"></a><span class="lineno">  351</span>                    <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_cli_req_pre_sized,</div>
<div class="line"><a id="l00352" name="l00352"></a><span class="lineno">  352</span>                    <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">Mdt_reader_ptr</a>* mdt_from_srv_or_null,</div>
<div class="line"><a id="l00353" name="l00353"></a><span class="lineno">  353</span>                    <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_srv_req,</div>
<div class="line"><a id="l00354" name="l00354"></a><span class="lineno">  354</span>                    <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code);</div>
<div class="line"><a id="l00355" name="l00355"></a><span class="lineno">  355</span><span class="comment"></span> </div>
<div class="line"><a id="l00356" name="l00356"></a><span class="lineno">  356</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00357" name="l00357"></a><span class="lineno">  357</span><span class="comment">   * See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00358" name="l00358"></a><span class="lineno">  358</span><span class="comment">   *</span></div>
<div class="line"><a id="l00359" name="l00359"></a><span class="lineno">  359</span><span class="comment">   * @param target_channel</span></div>
<div class="line"><a id="l00360" name="l00360"></a><span class="lineno">  360</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00361" name="l00361"></a><span class="lineno">  361</span><span class="comment">   * @param mdt</span></div>
<div class="line"><a id="l00362" name="l00362"></a><span class="lineno">  362</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00363" name="l00363"></a><span class="lineno">  363</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00364" name="l00364"></a><span class="lineno">  364</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00365" name="l00365"></a><span class="lineno">  365</span><span class="comment">   * @return See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00366" name="l00366"></a><span class="lineno">  366</span><span class="comment">   */</span></div>
<div class="line"><a id="l00367" name="l00367"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a4a377590fbf55b6d312f24d888d2a1bd">  367</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a4a377590fbf55b6d312f24d888d2a1bd">open_channel</a>(<a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">Channel_obj</a>* target_channel, <span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">Mdt_builder_ptr</a>&amp; mdt, <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code);</div>
<div class="line"><a id="l00368" name="l00368"></a><span class="lineno">  368</span><span class="comment"></span> </div>
<div class="line"><a id="l00369" name="l00369"></a><span class="lineno">  369</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00370" name="l00370"></a><span class="lineno">  370</span><span class="comment">   * See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00371" name="l00371"></a><span class="lineno">  371</span><span class="comment">   *</span></div>
<div class="line"><a id="l00372" name="l00372"></a><span class="lineno">  372</span><span class="comment">   * @param target_channel</span></div>
<div class="line"><a id="l00373" name="l00373"></a><span class="lineno">  373</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00374" name="l00374"></a><span class="lineno">  374</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00375" name="l00375"></a><span class="lineno">  375</span><span class="comment">   *        See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00376" name="l00376"></a><span class="lineno">  376</span><span class="comment">   * @return See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00377" name="l00377"></a><span class="lineno">  377</span><span class="comment">   */</span></div>
<div class="line"><a id="l00378" name="l00378"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#acaca4c5b8e56cf4cd29b5cc886993ded">  378</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#acaca4c5b8e56cf4cd29b5cc886993ded">open_channel</a>(<a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">Channel_obj</a>* target_channel, <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code);</div>
<div class="line"><a id="l00379" name="l00379"></a><span class="lineno">  379</span><span class="comment"></span> </div>
<div class="line"><a id="l00380" name="l00380"></a><span class="lineno">  380</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00381" name="l00381"></a><span class="lineno">  381</span><span class="comment">   * See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00382" name="l00382"></a><span class="lineno">  382</span><span class="comment">   * @return See Client_session_mv counterpart.</span></div>
<div class="line"><a id="l00383" name="l00383"></a><span class="lineno">  383</span><span class="comment">   */</span></div>
<div class="line"><a id="l00384" name="l00384"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aad9a5e95ffde170a6483b74f397d9169">  384</a></span>  <span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc_1_1session.html#ade2b302f1a3623e8adc9694568d94d2c">Session_token</a>&amp; <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#aad9a5e95ffde170a6483b74f397d9169">session_token</a>() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00385" name="l00385"></a><span class="lineno">  385</span> </div>
<div class="line"><a id="l00386" name="l00386"></a><span class="lineno">  386</span><span class="keyword">protected</span>:</div>
<div class="line"><a id="l00387" name="l00387"></a><span class="lineno">  387</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00388" name="l00388"></a><span class="lineno">  388</span><span class="comment"></span> </div>
<div class="line"><a id="l00389" name="l00389"></a><span class="lineno">  389</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00390" name="l00390"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a4c62a381340b0f494c4f117960bfca2b">  390</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a4c62a381340b0f494c4f117960bfca2b">Master_structured_channel</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a26d038e14e3c0e461e76de88c4ce76c5">Base::Master_structured_channel</a>;</div>
<div class="line"><a id="l00391" name="l00391"></a><span class="lineno">  391</span> </div>
<div class="line"><a id="l00392" name="l00392"></a><span class="lineno">  392</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l00393" name="l00393"></a><span class="lineno">  393</span><span class="comment"></span> </div>
<div class="line"><a id="l00394" name="l00394"></a><span class="lineno">  394</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00395" name="l00395"></a><span class="lineno">  395</span><span class="comment">   * Utility for `*this` and sub-classes: Implements sync_connect() given a functor that invokes</span></div>
<div class="line"><a id="l00396" name="l00396"></a><span class="lineno">  396</span><span class="comment">   * the calling class&#39;s (including Client_session_impl) async_connect() with the args passed to the calling</span></div>
<div class="line"><a id="l00397" name="l00397"></a><span class="lineno">  397</span><span class="comment">   * sync_connect().</span></div>
<div class="line"><a id="l00398" name="l00398"></a><span class="lineno">  398</span><span class="comment">   *</span></div>
<div class="line"><a id="l00399" name="l00399"></a><span class="lineno">  399</span><span class="comment">   * This allows sub-classes to reuse our straightforward `promise`-based implementation of sync_connect()</span></div>
<div class="line"><a id="l00400" name="l00400"></a><span class="lineno">  400</span><span class="comment">   * in terms of async_connect().  Otherwise they&#39;d need to copy/paste that stuff or something.</span></div>
<div class="line"><a id="l00401" name="l00401"></a><span class="lineno">  401</span><span class="comment">   * E.g., see shm::classic::Client_session_impl and/or shm::arena_lend::jemalloc::Client_session_impl.</span></div>
<div class="line"><a id="l00402" name="l00402"></a><span class="lineno">  402</span><span class="comment">   * If sub-classes were not an issue, sync_connect_impl() would not be needed; we&#39;d just call our</span></div>
<div class="line"><a id="l00403" name="l00403"></a><span class="lineno">  403</span><span class="comment">   * async_connect() directly.</span></div>
<div class="line"><a id="l00404" name="l00404"></a><span class="lineno">  404</span><span class="comment">   *</span></div>
<div class="line"><a id="l00405" name="l00405"></a><span class="lineno">  405</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00406" name="l00406"></a><span class="lineno">  406</span><span class="comment">   *        See sync_connect().</span></div>
<div class="line"><a id="l00407" name="l00407"></a><span class="lineno">  407</span><span class="comment">   * @param async_connect_impl_func</span></div>
<div class="line"><a id="l00408" name="l00408"></a><span class="lineno">  408</span><span class="comment">   *        Non-null pointer to a function that (1) calls `async_connect()`-like method, forwarding to it</span></div>
<div class="line"><a id="l00409" name="l00409"></a><span class="lineno">  409</span><span class="comment">   *        the args to the calling `sync_connect()`-like method, except (2) the last arg is to be a forward</span></div>
<div class="line"><a id="l00410" name="l00410"></a><span class="lineno">  410</span><span class="comment">   *        of the `on_done_func`-signature-matching arg to `async_connect_impl_func`.</span></div>
<div class="line"><a id="l00411" name="l00411"></a><span class="lineno">  411</span><span class="comment">   * @return See sync_connect().</span></div>
<div class="line"><a id="l00412" name="l00412"></a><span class="lineno">  412</span><span class="comment">   */</span></div>
<div class="line"><a id="l00413" name="l00413"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a1a7560109fa2aa2c16d4f4159918e2c2">  413</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a1a7560109fa2aa2c16d4f4159918e2c2">sync_connect_impl</a>(<a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code, <a class="code hl_typedef" href="namespaceipc.html#aa455c7f045059736578ca275fc1a851f">Function</a>&lt;<span class="keywordtype">bool</span> (flow::async::Task_asio_err&amp;&amp;)&gt;* async_connect_impl_func);</div>
<div class="line"><a id="l00414" name="l00414"></a><span class="lineno">  414</span><span class="comment"></span> </div>
<div class="line"><a id="l00415" name="l00415"></a><span class="lineno">  415</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00416" name="l00416"></a><span class="lineno">  416</span><span class="comment">   * Core implementation of sync_connect().</span></div>
<div class="line"><a id="l00417" name="l00417"></a><span class="lineno">  417</span><span class="comment">   * See &quot;CONNECTING state and asynchronicity&quot; in class doc header for key background.</span></div>
<div class="line"><a id="l00418" name="l00418"></a><span class="lineno">  418</span><span class="comment">   * </span></div>
<div class="line"><a id="l00419" name="l00419"></a><span class="lineno">  419</span><span class="comment">   * @return See sync_conect().</span></div>
<div class="line"><a id="l00420" name="l00420"></a><span class="lineno">  420</span><span class="comment">   * @param mdt</span></div>
<div class="line"><a id="l00421" name="l00421"></a><span class="lineno">  421</span><span class="comment">   *        See sync_conect().</span></div>
<div class="line"><a id="l00422" name="l00422"></a><span class="lineno">  422</span><span class="comment">   * @param init_channels_by_cli_req_pre_sized</span></div>
<div class="line"><a id="l00423" name="l00423"></a><span class="lineno">  423</span><span class="comment">   *        See sync_conect().</span></div>
<div class="line"><a id="l00424" name="l00424"></a><span class="lineno">  424</span><span class="comment">   * @param mdt_from_srv_or_null</span></div>
<div class="line"><a id="l00425" name="l00425"></a><span class="lineno">  425</span><span class="comment">   *        See sync_conect().</span></div>
<div class="line"><a id="l00426" name="l00426"></a><span class="lineno">  426</span><span class="comment">   * @param init_channels_by_srv_req</span></div>
<div class="line"><a id="l00427" name="l00427"></a><span class="lineno">  427</span><span class="comment">   *        See sync_conect().</span></div>
<div class="line"><a id="l00428" name="l00428"></a><span class="lineno">  428</span><span class="comment">   * @param on_done_func</span></div>
<div class="line"><a id="l00429" name="l00429"></a><span class="lineno">  429</span><span class="comment">   *        What to invoke in thread W on completion of the async-connect.  As of this writing this is supplied</span></div>
<div class="line"><a id="l00430" name="l00430"></a><span class="lineno">  430</span><span class="comment">   *        by sync_connect_impl() internal code.</span></div>
<div class="line"><a id="l00431" name="l00431"></a><span class="lineno">  431</span><span class="comment">   */</span></div>
<div class="line"><a id="l00432" name="l00432"></a><span class="lineno">  432</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l00433" name="l00433"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a56c0d2b0ff082d1f7b0738e2528b4a92">  433</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a56c0d2b0ff082d1f7b0738e2528b4a92">async_connect</a>(<span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">Mdt_builder_ptr</a>&amp; mdt,</div>
<div class="line"><a id="l00434" name="l00434"></a><span class="lineno">  434</span>                     <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_cli_req_pre_sized,</div>
<div class="line"><a id="l00435" name="l00435"></a><span class="lineno">  435</span>                     <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">Mdt_reader_ptr</a>* mdt_from_srv_or_null,</div>
<div class="line"><a id="l00436" name="l00436"></a><span class="lineno">  436</span>                     <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_srv_req,</div>
<div class="line"><a id="l00437" name="l00437"></a><span class="lineno">  437</span>                     Task_err&amp;&amp; on_done_func);</div>
<div class="line"><a id="l00438" name="l00438"></a><span class="lineno">  438</span><span class="comment"></span> </div>
<div class="line"><a id="l00439" name="l00439"></a><span class="lineno">  439</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00440" name="l00440"></a><span class="lineno">  440</span><span class="comment">   * Utility for sub-classes: executed from async_connect()&#39;s `on_done_func(Error_code())` (i.e., directly</span></div>
<div class="line"><a id="l00441" name="l00441"></a><span class="lineno">  441</span><span class="comment">   * from handler invoked on success) -- hence from thread W -- this instead goes back to NULL state,</span></div>
<div class="line"><a id="l00442" name="l00442"></a><span class="lineno">  442</span><span class="comment">   * essentially indicating &quot;never mind -- this successful async_connect() actually failed.&quot;</span></div>
<div class="line"><a id="l00443" name="l00443"></a><span class="lineno">  443</span><span class="comment">   *</span></div>
<div class="line"><a id="l00444" name="l00444"></a><span class="lineno">  444</span><span class="comment">   * This... um... highly specific utility is intended for overriding async_connect() impl that performs</span></div>
<div class="line"><a id="l00445" name="l00445"></a><span class="lineno">  445</span><span class="comment">   * *synchronous* post-processing in its own `on_done_func()` wrapper from sub-class&#39;s async_connect()</span></div>
<div class="line"><a id="l00446" name="l00446"></a><span class="lineno">  446</span><span class="comment">   * that calls this class&#39;s async_connect().</span></div>
<div class="line"><a id="l00447" name="l00447"></a><span class="lineno">  447</span><span class="comment">   */</span></div>
<div class="line"><a id="l00448" name="l00448"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a43d56aeae47d1fa815178ebd0ae1ff48">  448</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a43d56aeae47d1fa815178ebd0ae1ff48">cancel_peer_state_to_null</a>();</div>
<div class="line"><a id="l00449" name="l00449"></a><span class="lineno">  449</span><span class="comment"></span> </div>
<div class="line"><a id="l00450" name="l00450"></a><span class="lineno">  450</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00451" name="l00451"></a><span class="lineno">  451</span><span class="comment">   * Utility for sub-classes: executed from async_connect()&#39;s `on_done_func(Error_code())` (i.e., directly</span></div>
<div class="line"><a id="l00452" name="l00452"></a><span class="lineno">  452</span><span class="comment">   * from handler invoked on success) -- hence from thread W -- this instead goes back to CONNECTING state,</span></div>
<div class="line"><a id="l00453" name="l00453"></a><span class="lineno">  453</span><span class="comment">   * essentially indicating &quot;yes, the vanilla async_connect() succeeded, but the true user-called async_connect()</span></div>
<div class="line"><a id="l00454" name="l00454"></a><span class="lineno">  454</span><span class="comment">   * that piggybacked on the vanilla one will now do some more async stuff before reaching PEER state (or NULL on</span></div>
<div class="line"><a id="l00455" name="l00455"></a><span class="lineno">  455</span><span class="comment">   * error).&quot;</span></div>
<div class="line"><a id="l00456" name="l00456"></a><span class="lineno">  456</span><span class="comment">   *</span></div>
<div class="line"><a id="l00457" name="l00457"></a><span class="lineno">  457</span><span class="comment">   * As `on_done_func` was already invoked (and thus forgotten), the caller must supply a new</span></div>
<div class="line"><a id="l00458" name="l00458"></a><span class="lineno">  458</span><span class="comment">   * one to execute once either PEER or NULL state is reached again.  Since `*this` has completed its vanilla</span></div>
<div class="line"><a id="l00459" name="l00459"></a><span class="lineno">  459</span><span class="comment">   * async_connect() work already, the responsibility for reaching one of those 2 states is now on the caller.</span></div>
<div class="line"><a id="l00460" name="l00460"></a><span class="lineno">  460</span><span class="comment">   * Therefore whatever async processing follows our invocation is required to call</span></div>
<div class="line"><a id="l00461" name="l00461"></a><span class="lineno">  461</span><span class="comment">   * complete_async_connect_after_canceling_peer_state().  That said, if a master-session-channel error occurs before</span></div>
<div class="line"><a id="l00462" name="l00462"></a><span class="lineno">  462</span><span class="comment">   * that has a chance to be called, then:</span></div>
<div class="line"><a id="l00463" name="l00463"></a><span class="lineno">  463</span><span class="comment">   *   - `*this` will enter NULL state itself.</span></div>
<div class="line"><a id="l00464" name="l00464"></a><span class="lineno">  464</span><span class="comment">   *   - `*this` will invoke the handler supplied here to cancel_peer_state_to_connecting().</span></div>
<div class="line"><a id="l00465" name="l00465"></a><span class="lineno">  465</span><span class="comment">   *</span></div>
<div class="line"><a id="l00466" name="l00466"></a><span class="lineno">  466</span><span class="comment">   * The session master channel is returned, so that the sub-class can take over operation as needed until</span></div>
<div class="line"><a id="l00467" name="l00467"></a><span class="lineno">  467</span><span class="comment">   * either complete_async_connect_after_canceling_peer_state() or that channel becoming hosed (either way</span></div>
<div class="line"><a id="l00468" name="l00468"></a><span class="lineno">  468</span><span class="comment">   * on_done_func() will be invoked).  This avoids providing unrestricted `protected` access to it all times.</span></div>
<div class="line"><a id="l00469" name="l00469"></a><span class="lineno">  469</span><span class="comment">   * See also async_worker().</span></div>
<div class="line"><a id="l00470" name="l00470"></a><span class="lineno">  470</span><span class="comment">   *</span></div>
<div class="line"><a id="l00471" name="l00471"></a><span class="lineno">  471</span><span class="comment">   * @tparam Task_err</span></div>
<div class="line"><a id="l00472" name="l00472"></a><span class="lineno">  472</span><span class="comment">   *         See async_connect().</span></div>
<div class="line"><a id="l00473" name="l00473"></a><span class="lineno">  473</span><span class="comment">   * @param on_done_func</span></div>
<div class="line"><a id="l00474" name="l00474"></a><span class="lineno">  474</span><span class="comment">   *        See async_connect().</span></div>
<div class="line"><a id="l00475" name="l00475"></a><span class="lineno">  475</span><span class="comment">   * @return See above.</span></div>
<div class="line"><a id="l00476" name="l00476"></a><span class="lineno">  476</span><span class="comment">   */</span></div>
<div class="line"><a id="l00477" name="l00477"></a><span class="lineno">  477</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l00478" name="l00478"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#adac4cba3aefa629566f182a240b4cedd">  478</a></span>  <a class="code hl_class" href="classipc_1_1transport_1_1struc_1_1Channel.html">Master_structured_channel</a>* <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#adac4cba3aefa629566f182a240b4cedd">cancel_peer_state_to_connecting</a>(Task_err&amp;&amp; on_done_func);</div>
<div class="line"><a id="l00479" name="l00479"></a><span class="lineno">  479</span><span class="comment"></span> </div>
<div class="line"><a id="l00480" name="l00480"></a><span class="lineno">  480</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00481" name="l00481"></a><span class="lineno">  481</span><span class="comment">   * Utility for sub-classes: to be invoked, only from thread W and asynchronously at that, after</span></div>
<div class="line"><a id="l00482" name="l00482"></a><span class="lineno">  482</span><span class="comment">   * cancel_peer_state_to_connecting(), this indicates the completion of the sub-class&#39;s additional async-connect</span></div>
<div class="line"><a id="l00483" name="l00483"></a><span class="lineno">  483</span><span class="comment">   * steps, setting state to either NULL or PEER.  Invoke only in CONNECTING state; else undefined behavior</span></div>
<div class="line"><a id="l00484" name="l00484"></a><span class="lineno">  484</span><span class="comment">   * (assertion may trip).</span></div>
<div class="line"><a id="l00485" name="l00485"></a><span class="lineno">  485</span><span class="comment">   *</span></div>
<div class="line"><a id="l00486" name="l00486"></a><span class="lineno">  486</span><span class="comment">   * The handler given to cancel_peer_state_to_connecting() will execute.</span></div>
<div class="line"><a id="l00487" name="l00487"></a><span class="lineno">  487</span><span class="comment">   *</span></div>
<div class="line"><a id="l00488" name="l00488"></a><span class="lineno">  488</span><span class="comment">   * Take care to check Session_base::hosed() as needed before calling this; if hosed then do not call.</span></div>
<div class="line"><a id="l00489" name="l00489"></a><span class="lineno">  489</span><span class="comment">   *</span></div>
<div class="line"><a id="l00490" name="l00490"></a><span class="lineno">  490</span><span class="comment">   * @param err_code_or_success</span></div>
<div class="line"><a id="l00491" name="l00491"></a><span class="lineno">  491</span><span class="comment">   *        State will proceed to PEER if falsy else to NULL; in the latter case the given code shall be passed to</span></div>
<div class="line"><a id="l00492" name="l00492"></a><span class="lineno">  492</span><span class="comment">   *        handler as the reason for failure to ultimately async-connect.</span></div>
<div class="line"><a id="l00493" name="l00493"></a><span class="lineno">  493</span><span class="comment">   */</span></div>
<div class="line"><a id="l00494" name="l00494"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a313e2fc3d4017232bad4fac2baae20a4">  494</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a313e2fc3d4017232bad4fac2baae20a4">complete_async_connect_after_canceling_peer_state</a>(<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; err_code_or_success);</div>
<div class="line"><a id="l00495" name="l00495"></a><span class="lineno">  495</span><span class="comment"></span> </div>
<div class="line"><a id="l00496" name="l00496"></a><span class="lineno">  496</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00497" name="l00497"></a><span class="lineno">  497</span><span class="comment">   * Utility for sub-classes: provides ability to schedule or post tasks onto thread W.</span></div>
<div class="line"><a id="l00498" name="l00498"></a><span class="lineno">  498</span><span class="comment">   * @return See above.</span></div>
<div class="line"><a id="l00499" name="l00499"></a><span class="lineno">  499</span><span class="comment">   */</span></div>
<div class="line"><a id="l00500" name="l00500"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ab792f2389fd035827ae8dbead1650b78">  500</a></span>  flow::async::Single_thread_task_loop* <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#ab792f2389fd035827ae8dbead1650b78">async_worker</a>();</div>
<div class="line"><a id="l00501" name="l00501"></a><span class="lineno">  501</span><span class="comment"></span> </div>
<div class="line"><a id="l00502" name="l00502"></a><span class="lineno">  502</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00503" name="l00503"></a><span class="lineno">  503</span><span class="comment">   * Utility for sub-classes: provides ability to *immutably query* the session master channel, particularly after</span></div>
<div class="line"><a id="l00504" name="l00504"></a><span class="lineno">  504</span><span class="comment">   * our async_accept_log_in() succeeds, but before the sub-classed wrapper of its on-done handler succeeds.</span></div>
<div class="line"><a id="l00505" name="l00505"></a><span class="lineno">  505</span><span class="comment">   * For example one can harmlessly query transport::struc::Channel::session_token().</span></div>
<div class="line"><a id="l00506" name="l00506"></a><span class="lineno">  506</span><span class="comment">   *</span></div>
<div class="line"><a id="l00507" name="l00507"></a><span class="lineno">  507</span><span class="comment">   * `protected` but `const` access does not much bother me (ygoldfel) stylistically.</span></div>
<div class="line"><a id="l00508" name="l00508"></a><span class="lineno">  508</span><span class="comment">   *</span></div>
<div class="line"><a id="l00509" name="l00509"></a><span class="lineno">  509</span><span class="comment">   * @return See above.</span></div>
<div class="line"><a id="l00510" name="l00510"></a><span class="lineno">  510</span><span class="comment">   */</span></div>
<div class="line"><a id="l00511" name="l00511"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a5f156b23ce19cd878c3e83330e63f56f">  511</a></span>  <span class="keyword">const</span> <a class="code hl_class" href="classipc_1_1transport_1_1struc_1_1Channel.html">Master_structured_channel</a>&amp; <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a5f156b23ce19cd878c3e83330e63f56f">master_channel_const</a>() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00512" name="l00512"></a><span class="lineno">  512</span><span class="comment"></span> </div>
<div class="line"><a id="l00513" name="l00513"></a><span class="lineno">  513</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00514" name="l00514"></a><span class="lineno">  514</span><span class="comment">   * Synchronously stops async_worker() loop, the post-condition being that thread W has been joined; no tasks</span></div>
<div class="line"><a id="l00515" name="l00515"></a><span class="lineno">  515</span><span class="comment">   * `post()`ed onto it by `*this` or subclass shall execute after this returns.</span></div>
<div class="line"><a id="l00516" name="l00516"></a><span class="lineno">  516</span><span class="comment">   *   - If `*this` is not being subclassed, or if it never posts onto async_worker(): Our own dtor shall call</span></div>
<div class="line"><a id="l00517" name="l00517"></a><span class="lineno">  517</span><span class="comment">   *     this first-thing; no need for subclass to worry.</span></div>
<div class="line"><a id="l00518" name="l00518"></a><span class="lineno">  518</span><span class="comment">   *   - If `*this` is being subclassed, and it does post onto async_worker(): The terminal subclass&#39;s dtor must</span></div>
<div class="line"><a id="l00519" name="l00519"></a><span class="lineno">  519</span><span class="comment">   *     call this ~first-thing (our own dtor, once it is soon called, shall know not to re-execute the same thing).</span></div>
<div class="line"><a id="l00520" name="l00520"></a><span class="lineno">  520</span><span class="comment">   *</span></div>
<div class="line"><a id="l00521" name="l00521"></a><span class="lineno">  521</span><span class="comment">   * Call at most once; otherwise undefined behavior (assertion may trip).</span></div>
<div class="line"><a id="l00522" name="l00522"></a><span class="lineno">  522</span><span class="comment">   *</span></div>
<div class="line"><a id="l00523" name="l00523"></a><span class="lineno">  523</span><span class="comment">   * This exists to avoid a race, however unlikely, between a subclass&#39;s asynchronous accept-log-in code posted</span></div>
<div class="line"><a id="l00524" name="l00524"></a><span class="lineno">  524</span><span class="comment">   * onto thread W, and that same class&#39;s dtor being invoked by the user in thread U.  There is a short time period,</span></div>
<div class="line"><a id="l00525" name="l00525"></a><span class="lineno">  525</span><span class="comment">   * when thread W (#m_async_worker) is active -- `*this` is still intact -- but the subclass&#39;s members are being</span></div>
<div class="line"><a id="l00526" name="l00526"></a><span class="lineno">  526</span><span class="comment">   * destroyed by its dtor.  In that case dtor_async_worker_stop() would be called by the subclass dtor to put an</span></div>
<div class="line"><a id="l00527" name="l00527"></a><span class="lineno">  527</span><span class="comment">   * end to async shenanigans in thread W, so it can continue destroying self in peace.  When there is no subclass,</span></div>
<div class="line"><a id="l00528" name="l00528"></a><span class="lineno">  528</span><span class="comment">   * our own dtor does so.</span></div>
<div class="line"><a id="l00529" name="l00529"></a><span class="lineno">  529</span><span class="comment">   */</span></div>
<div class="line"><a id="l00530" name="l00530"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#afb09c3a23b7e63938b9a494cec6e769b">  530</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#afb09c3a23b7e63938b9a494cec6e769b">dtor_async_worker_stop</a>();</div>
<div class="line"><a id="l00531" name="l00531"></a><span class="lineno">  531</span> </div>
<div class="line"><a id="l00532" name="l00532"></a><span class="lineno">  532</span><span class="keyword">private</span>:</div>
<div class="line"><a id="l00533" name="l00533"></a><span class="lineno">  533</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00534" name="l00534"></a><span class="lineno">  534</span><span class="comment"></span> </div>
<div class="line"><a id="l00535" name="l00535"></a><span class="lineno">  535</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00536" name="l00536"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ad432ab4e95ddcfd0396d5ea821dec15c">  536</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad432ab4e95ddcfd0396d5ea821dec15c">Master_structured_channel_ptr</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#af0ca2a01d7d0d92038aae56fc1cdd505">Base::Master_structured_channel_ptr</a>;</div>
<div class="line"><a id="l00537" name="l00537"></a><span class="lineno">  537</span><span class="comment"></span> </div>
<div class="line"><a id="l00538" name="l00538"></a><span class="lineno">  538</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00539" name="l00539"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a6a1cb9c344c312b4eff5c360d7114e2c">  539</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a6a1cb9c344c312b4eff5c360d7114e2c">Master_structured_channel_observer</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ae2a123b29dd044a638e94d1f294c8f28">Base::Master_structured_channel_observer</a>;</div>
<div class="line"><a id="l00540" name="l00540"></a><span class="lineno">  540</span><span class="comment"></span> </div>
<div class="line"><a id="l00541" name="l00541"></a><span class="lineno">  541</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00542" name="l00542"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aa4a518c48b0611e13ad4982d067674f7">  542</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aa4a518c48b0611e13ad4982d067674f7">Persistent_mq_handle_from_cfg</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a848c0f5247644ada0f8b0ab816eedda8">Base::Persistent_mq_handle_from_cfg</a>;</div>
<div class="line"><a id="l00543" name="l00543"></a><span class="lineno">  543</span><span class="comment"></span> </div>
<div class="line"><a id="l00544" name="l00544"></a><span class="lineno">  544</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00545" name="l00545"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ad6624a4b1f7fd6e24bdde50b323b8f97">  545</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad6624a4b1f7fd6e24bdde50b323b8f97">On_passive_open_channel_func</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a3c0824a54ef32915c5c5ea76481f2409">Base::On_passive_open_channel_func</a>;</div>
<div class="line"><a id="l00546" name="l00546"></a><span class="lineno">  546</span><span class="comment"></span> </div>
<div class="line"><a id="l00547" name="l00547"></a><span class="lineno">  547</span><span class="comment">  /// Overall state of a Client_session_impl.</span></div>
<div class="line"><a id="l00548" name="l00548"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#af7a951bd266bdd0e3339a0fbddba9e8b">  548</a></span><span class="comment"></span>  <span class="keyword">enum class</span> <a class="code hl_enumeration" href="classipc_1_1session_1_1Client__session__impl.html#af7a951bd266bdd0e3339a0fbddba9e8b">State</a></div>
<div class="line"><a id="l00549" name="l00549"></a><span class="lineno">  549</span>  {<span class="comment"></span></div>
<div class="line"><a id="l00550" name="l00550"></a><span class="lineno">  550</span><span class="comment">    /**</span></div>
<div class="line"><a id="l00551" name="l00551"></a><span class="lineno">  551</span><span class="comment">     * Not a peer.  Initial state; goes to CONNECTING (via async_connect()).</span></div>
<div class="line"><a id="l00552" name="l00552"></a><span class="lineno">  552</span><span class="comment">     * Only async_connect() is possible in this state (other public mutators return immediately).</span></div>
<div class="line"><a id="l00553" name="l00553"></a><span class="lineno">  553</span><span class="comment">     */</span></div>
<div class="line"><a id="l00554" name="l00554"></a><span class="lineno">  554</span>    S_NULL,</div>
<div class="line"><a id="l00555" name="l00555"></a><span class="lineno">  555</span><span class="comment"></span> </div>
<div class="line"><a id="l00556" name="l00556"></a><span class="lineno">  556</span><span class="comment">    /**</span></div>
<div class="line"><a id="l00557" name="l00557"></a><span class="lineno">  557</span><span class="comment">     * Not a peer but async_connect() in progress to try to make it a peer.  Barring moves-from/moves-to:</span></div>
<div class="line"><a id="l00558" name="l00558"></a><span class="lineno">  558</span><span class="comment">     * Entry from NULL; goes to PEER or NULL.</span></div>
<div class="line"><a id="l00559" name="l00559"></a><span class="lineno">  559</span><span class="comment">     */</span></div>
<div class="line"><a id="l00560" name="l00560"></a><span class="lineno">  560</span>    S_CONNECTING,</div>
<div class="line"><a id="l00561" name="l00561"></a><span class="lineno">  561</span><span class="comment"></span> </div>
<div class="line"><a id="l00562" name="l00562"></a><span class="lineno">  562</span><span class="comment">    /**</span></div>
<div class="line"><a id="l00563" name="l00563"></a><span class="lineno">  563</span><span class="comment">     * Is or was a connected peer.  Entry from CONNECTING; does not transition to any other state</span></div>
<div class="line"><a id="l00564" name="l00564"></a><span class="lineno">  564</span><span class="comment">     * (once a PEER, always a PEER).  `*_connect()` is not possible in this state (it returns immediately); all</span></div>
<div class="line"><a id="l00565" name="l00565"></a><span class="lineno">  565</span><span class="comment">     * other mutating public methods are possible.</span></div>
<div class="line"><a id="l00566" name="l00566"></a><span class="lineno">  566</span><span class="comment">     */</span></div>
<div class="line"><a id="l00567" name="l00567"></a><span class="lineno">  567</span>    S_PEER</div>
<div class="line"><a id="l00568" name="l00568"></a><span class="lineno">  568</span>  }; <span class="comment">// enum class State</span></div>
<div class="line"><a id="l00569" name="l00569"></a><span class="lineno">  569</span><span class="comment"></span> </div>
<div class="line"><a id="l00570" name="l00570"></a><span class="lineno">  570</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00571" name="l00571"></a><span class="lineno">  571</span><span class="comment">   * An open-channel/log-in request out-message.  Together with that is stored a `Builder` into its metadata</span></div>
<div class="line"><a id="l00572" name="l00572"></a><span class="lineno">  572</span><span class="comment">   * sub-field.</span></div>
<div class="line"><a id="l00573" name="l00573"></a><span class="lineno">  573</span><span class="comment">   *</span></div>
<div class="line"><a id="l00574" name="l00574"></a><span class="lineno">  574</span><span class="comment">   * ### Rationale ###</span></div>
<div class="line"><a id="l00575" name="l00575"></a><span class="lineno">  575</span><span class="comment">   * This explanation is written for open_channel() case, but the same applies for the log-in request and</span></div>
<div class="line"><a id="l00576" name="l00576"></a><span class="lineno">  576</span><span class="comment">   * async_connect().</span></div>
<div class="line"><a id="l00577" name="l00577"></a><span class="lineno">  577</span><span class="comment">   *</span></div>
<div class="line"><a id="l00578" name="l00578"></a><span class="lineno">  578</span><span class="comment">   * Why store the `Builder`, if it can always be obtained from #m_req_msg?  Answer: On one hand,</span></div>
<div class="line"><a id="l00579" name="l00579"></a><span class="lineno">  579</span><span class="comment">   * mdt_builder() needs to return that `Builder`, so that the user can set the metadata.  However,</span></div>
<div class="line"><a id="l00580" name="l00580"></a><span class="lineno">  580</span><span class="comment">   * open_channel() aims to then stuff the underlying bits into the open-channel request out-message which is</span></div>
<div class="line"><a id="l00581" name="l00581"></a><span class="lineno">  581</span><span class="comment">   * is our internal impl detail, unknown to the user.  We could return a stand-alone just-the-metadata structure</span></div>
<div class="line"><a id="l00582" name="l00582"></a><span class="lineno">  582</span><span class="comment">   * and `Builder` to it, but (1) then we&#39;d have to transfer that over into the out-message -- slow, possibly</span></div>
<div class="line"><a id="l00583" name="l00583"></a><span class="lineno">  583</span><span class="comment">   * painful (involving capnp orphans), and (2) it has to be backed by a `MessageBuilder`.  So we&#39;d have to</span></div>
<div class="line"><a id="l00584" name="l00584"></a><span class="lineno">  584</span><span class="comment">   * set up a `MallocMessageBuilder` or something just for this thing -- only to end up painfully copying over</span></div>
<div class="line"><a id="l00585" name="l00585"></a><span class="lineno">  585</span><span class="comment">   * data from one serialization to another.  Instead we maintain zero-copy and avoid these issues:</span></div>
<div class="line"><a id="l00586" name="l00586"></a><span class="lineno">  586</span><span class="comment">   *   - Set up the open-channel request out-message directly in mdt_builder().  (Its ref-count shall</span></div>
<div class="line"><a id="l00587" name="l00587"></a><span class="lineno">  587</span><span class="comment">   *     always be 1.)</span></div>
<div class="line"><a id="l00588" name="l00588"></a><span class="lineno">  588</span><span class="comment">   *   - Point a `Builder` to the metadata sub-field.</span></div>
<div class="line"><a id="l00589" name="l00589"></a><span class="lineno">  589</span><span class="comment">   *   - Wrap both things in this `struct` and wrap that in a `shared_ptr`.</span></div>
<div class="line"><a id="l00590" name="l00590"></a><span class="lineno">  590</span><span class="comment">   *   - Lastly have mdt_builder() return an *alias* `shared_ptr` that (to the user) looks like it&#39;s</span></div>
<div class="line"><a id="l00591" name="l00591"></a><span class="lineno">  591</span><span class="comment">   *     to just the `Builder` (all they care about), but it&#39;s actually in the `shared_ptr` group of the real</span></div>
<div class="line"><a id="l00592" name="l00592"></a><span class="lineno">  592</span><span class="comment">   *     ref-counted datum, this `struct`.</span></div>
<div class="line"><a id="l00593" name="l00593"></a><span class="lineno">  593</span><span class="comment">   *   - open_channel() receives the alias, which points to the `Builder`.  Since the `Builder` is the first</span></div>
<div class="line"><a id="l00594" name="l00594"></a><span class="lineno">  594</span><span class="comment">   *     member of this `struct`, its raw address (by C++ aliasing rules) equals that of the whole `struct`.</span></div>
<div class="line"><a id="l00595" name="l00595"></a><span class="lineno">  595</span><span class="comment">   *     Hence open_channel() can get to the `struct` and thus to the out-message member #m_req_msg.  It can</span></div>
<div class="line"><a id="l00596" name="l00596"></a><span class="lineno">  596</span><span class="comment">   *     then transport::struc::Channel::send() that.</span></div>
<div class="line"><a id="l00597" name="l00597"></a><span class="lineno">  597</span><span class="comment">   */</span></div>
<div class="line"><a id="l00598" name="l00598"></a><span class="lineno"><a class="line" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html">  598</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html">Master_channel_req</a></div>
<div class="line"><a id="l00599" name="l00599"></a><span class="lineno">  599</span>  {</div>
<div class="line"><a id="l00600" name="l00600"></a><span class="lineno">  600</span>    <span class="comment">// Data.</span></div>
<div class="line"><a id="l00601" name="l00601"></a><span class="lineno">  601</span><span class="comment"></span> </div>
<div class="line"><a id="l00602" name="l00602"></a><span class="lineno">  602</span><span class="comment">    /**</span></div>
<div class="line"><a id="l00603" name="l00603"></a><span class="lineno">  603</span><span class="comment">     * The `Builder` `m_req_msg-&gt;body_root()-&gt;getMetadata()`.</span></div>
<div class="line"><a id="l00604" name="l00604"></a><span class="lineno">  604</span><span class="comment">     * @warning As of this writing this *must* be the first member.  Otherwise one would need to use something like</span></div>
<div class="line"><a id="l00605" name="l00605"></a><span class="lineno">  605</span><span class="comment">     *          `offsetof` to be able to get from `&amp;m_mdt_builder` (what mdt_builder() returns)</span></div>
<div class="line"><a id="l00606" name="l00606"></a><span class="lineno">  606</span><span class="comment">     *          to `this` and hence to #m_req_msg to `send()`.</span></div>
<div class="line"><a id="l00607" name="l00607"></a><span class="lineno">  607</span><span class="comment">     */</span></div>
<div class="line"><a id="l00608" name="l00608"></a><span class="lineno"><a class="line" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html#a91c936c8824be5dfc7112a5b02fc730d">  608</a></span>    <span class="keyword">typename</span> Mdt_builder_ptr::element_type <a class="code hl_variable" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html#a91c936c8824be5dfc7112a5b02fc730d">m_mdt_builder</a>;</div>
<div class="line"><a id="l00609" name="l00609"></a><span class="lineno">  609</span><span class="comment"></span> </div>
<div class="line"><a id="l00610" name="l00610"></a><span class="lineno">  610</span><span class="comment">    /// The open-channel-request-to-server out-message for the session master channel (in subsequent open_channel()).</span></div>
<div class="line"><a id="l00611" name="l00611"></a><span class="lineno"><a class="line" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html#a8cab22f0afe897330ad77a2bc2b536b7">  611</a></span><span class="comment"></span>    <span class="keyword">typename</span> Master_structured_channel::Msg_out <a class="code hl_variable" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html#a8cab22f0afe897330ad77a2bc2b536b7">m_req_msg</a>;</div>
<div class="line"><a id="l00612" name="l00612"></a><span class="lineno">  612</span>  };</div>
<div class="line"><a id="l00613" name="l00613"></a><span class="lineno">  613</span><span class="comment"></span> </div>
<div class="line"><a id="l00614" name="l00614"></a><span class="lineno">  614</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00615" name="l00615"></a><span class="lineno">  615</span><span class="comment">   * Short-hand for ref-counted pointer to Master_channel_req.</span></div>
<div class="line"><a id="l00616" name="l00616"></a><span class="lineno">  616</span><span class="comment">   * @see Master_channel_req doc header for info on the true nature of such `shared_ptr` as returned by us.</span></div>
<div class="line"><a id="l00617" name="l00617"></a><span class="lineno">  617</span><span class="comment">   */</span></div>
<div class="line"><a id="l00618" name="l00618"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#abe6c733821534ec020b7cec02cfc3e66">  618</a></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#abe6c733821534ec020b7cec02cfc3e66">Master_channel_req_ptr</a> = boost::shared_ptr&lt;Master_channel_req&gt;;</div>
<div class="line"><a id="l00619" name="l00619"></a><span class="lineno">  619</span> </div>
<div class="line"><a id="l00620" name="l00620"></a><span class="lineno">  620</span>  <span class="comment">// Constructors.</span></div>
<div class="line"><a id="l00621" name="l00621"></a><span class="lineno">  621</span><span class="comment"></span> </div>
<div class="line"><a id="l00622" name="l00622"></a><span class="lineno">  622</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00623" name="l00623"></a><span class="lineno">  623</span><span class="comment">   * Delegated-to ctor that implements both non-default `public` ctors.</span></div>
<div class="line"><a id="l00624" name="l00624"></a><span class="lineno">  624</span><span class="comment">   *</span></div>
<div class="line"><a id="l00625" name="l00625"></a><span class="lineno">  625</span><span class="comment">   * @param logger_ptr</span></div>
<div class="line"><a id="l00626" name="l00626"></a><span class="lineno">  626</span><span class="comment">   *        See public ctors.</span></div>
<div class="line"><a id="l00627" name="l00627"></a><span class="lineno">  627</span><span class="comment">   * @param cli_app_ref</span></div>
<div class="line"><a id="l00628" name="l00628"></a><span class="lineno">  628</span><span class="comment">   *        See public ctors.</span></div>
<div class="line"><a id="l00629" name="l00629"></a><span class="lineno">  629</span><span class="comment">   * @param srv_app_ref</span></div>
<div class="line"><a id="l00630" name="l00630"></a><span class="lineno">  630</span><span class="comment">   *        See public ctors.</span></div>
<div class="line"><a id="l00631" name="l00631"></a><span class="lineno">  631</span><span class="comment">   * @param on_err_func</span></div>
<div class="line"><a id="l00632" name="l00632"></a><span class="lineno">  632</span><span class="comment">   *        See public ctors.  This is the concretely-typed version of that arg.</span></div>
<div class="line"><a id="l00633" name="l00633"></a><span class="lineno">  633</span><span class="comment">   * @param on_passive_open_channel_func_or_empty_arg</span></div>
<div class="line"><a id="l00634" name="l00634"></a><span class="lineno">  634</span><span class="comment">   *        See public ctors.  This is the concretely-typed version of that arg; `.empty()` if the version</span></div>
<div class="line"><a id="l00635" name="l00635"></a><span class="lineno">  635</span><span class="comment">   *        without this arg was used.</span></div>
<div class="line"><a id="l00636" name="l00636"></a><span class="lineno">  636</span><span class="comment">   * @param tag</span></div>
<div class="line"><a id="l00637" name="l00637"></a><span class="lineno">  637</span><span class="comment">   *        Ctor-selecting tag.</span></div>
<div class="line"><a id="l00638" name="l00638"></a><span class="lineno">  638</span><span class="comment">   */</span></div>
<div class="line"><a id="l00639" name="l00639"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aeaf64876702dffaab7441e3006195134">  639</a></span>  <span class="keyword">explicit</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#aeaf64876702dffaab7441e3006195134">Client_session_impl</a>(flow::log::Logger* logger_ptr,</div>
<div class="line"><a id="l00640" name="l00640"></a><span class="lineno">  640</span>                               <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>&amp; cli_app_ref, <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__app.html">Server_app</a>&amp; srv_app_ref,</div>
<div class="line"><a id="l00641" name="l00641"></a><span class="lineno">  641</span>                               flow::async::Task_asio_err&amp;&amp; on_err_func,</div>
<div class="line"><a id="l00642" name="l00642"></a><span class="lineno">  642</span>                               <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a3c0824a54ef32915c5c5ea76481f2409">On_passive_open_channel_func</a>&amp;&amp; on_passive_open_channel_func_or_empty_arg,</div>
<div class="line"><a id="l00643" name="l00643"></a><span class="lineno">  643</span>                               std::nullptr_t tag);</div>
<div class="line"><a id="l00644" name="l00644"></a><span class="lineno">  644</span> </div>
<div class="line"><a id="l00645" name="l00645"></a><span class="lineno">  645</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l00646" name="l00646"></a><span class="lineno">  646</span><span class="comment"></span> </div>
<div class="line"><a id="l00647" name="l00647"></a><span class="lineno">  647</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00648" name="l00648"></a><span class="lineno">  648</span><span class="comment">   * In thread W, handler for #m_master_channel indicating incoming-direction channel-hosing error.</span></div>
<div class="line"><a id="l00649" name="l00649"></a><span class="lineno">  649</span><span class="comment">   * It is possible that #m_master_channel has been `.reset()` in the meantime, by seeing log-in failure</span></div>
<div class="line"><a id="l00650" name="l00650"></a><span class="lineno">  650</span><span class="comment">   * in on_master_channel_log_in_rsp(), and no longer exists.  This is tested via the observer arg.</span></div>
<div class="line"><a id="l00651" name="l00651"></a><span class="lineno">  651</span><span class="comment">   *</span></div>
<div class="line"><a id="l00652" name="l00652"></a><span class="lineno">  652</span><span class="comment">   * @param master_channel_observer</span></div>
<div class="line"><a id="l00653" name="l00653"></a><span class="lineno">  653</span><span class="comment">   *        `weak_ptr` observer of #m_master_channel at the time it was constructed.</span></div>
<div class="line"><a id="l00654" name="l00654"></a><span class="lineno">  654</span><span class="comment">   *        `master_channel_observer.lock()` is either null (we&#39;ve destroyed #m_master_channel due to another</span></div>
<div class="line"><a id="l00655" name="l00655"></a><span class="lineno">  655</span><span class="comment">   *        error condition) or equals #m_master_channel.</span></div>
<div class="line"><a id="l00656" name="l00656"></a><span class="lineno">  656</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00657" name="l00657"></a><span class="lineno">  657</span><span class="comment">   *        The non-success #Error_code from `struc::Channel`.</span></div>
<div class="line"><a id="l00658" name="l00658"></a><span class="lineno">  658</span><span class="comment">   */</span></div>
<div class="line"><a id="l00659" name="l00659"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a417e9c40eefdfb4622f84275795640c4">  659</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a417e9c40eefdfb4622f84275795640c4">on_master_channel_error</a>(<span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ae2a123b29dd044a638e94d1f294c8f28">Master_structured_channel_observer</a>&amp; master_channel_observer,</div>
<div class="line"><a id="l00660" name="l00660"></a><span class="lineno">  660</span>                               <span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; err_code);</div>
<div class="line"><a id="l00661" name="l00661"></a><span class="lineno">  661</span><span class="comment"></span> </div>
<div class="line"><a id="l00662" name="l00662"></a><span class="lineno">  662</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00663" name="l00663"></a><span class="lineno">  663</span><span class="comment">   * In thread W, handler for the successful receipt of log-in response (upon `send()`ing the log-in request),</span></div>
<div class="line"><a id="l00664" name="l00664"></a><span class="lineno">  664</span><span class="comment">   * as invoked in CONNECTING state only if the low-level transport::Native_socket_stream::async_connect() succeeded.</span></div>
<div class="line"><a id="l00665" name="l00665"></a><span class="lineno">  665</span><span class="comment">   *</span></div>
<div class="line"><a id="l00666" name="l00666"></a><span class="lineno">  666</span><span class="comment">   * Post-condition:</span></div>
<div class="line"><a id="l00667" name="l00667"></a><span class="lineno">  667</span><span class="comment">   *   - If no init-channels requested by client (async_connect() advanced-use) *nor*</span></div>
<div class="line"><a id="l00668" name="l00668"></a><span class="lineno">  668</span><span class="comment">   *     by server (as indicated in `log_in_rsp` itself):</span></div>
<div class="line"><a id="l00669" name="l00669"></a><span class="lineno">  669</span><span class="comment">   *     #m_state changed from CONNECTING to either NULL or PEER, depending on whether the log-in</span></div>
<div class="line"><a id="l00670" name="l00670"></a><span class="lineno">  670</span><span class="comment">   *     response `log_in_rsp` indicates server side OKed the log-in.  Per the invariant in #m_master_channel doc</span></div>
<div class="line"><a id="l00671" name="l00671"></a><span class="lineno">  671</span><span class="comment">   *     header: #m_master_channel is null (state became NULL) or non-null (state became PEER).  In the former case</span></div>
<div class="line"><a id="l00672" name="l00672"></a><span class="lineno">  672</span><span class="comment">   *     async_connect() can be attempted again.</span></div>
<div class="line"><a id="l00673" name="l00673"></a><span class="lineno">  673</span><span class="comment">   *   - Otherwise (if 1+ such channels, in total, requested):</span></div>
<div class="line"><a id="l00674" name="l00674"></a><span class="lineno">  674</span><span class="comment">   *     #m_state unchanged from CONNECTING; on_master_channel_init_open_channel() shall be executed once</span></div>
<div class="line"><a id="l00675" name="l00675"></a><span class="lineno">  675</span><span class="comment">   *     per requested (by either side) init-channel generated by opposing server.</span></div>
<div class="line"><a id="l00676" name="l00676"></a><span class="lineno">  676</span><span class="comment">   *     - on_master_channel_init_open_channel() (the last one) shall move to PEER state in our stead.</span></div>
<div class="line"><a id="l00677" name="l00677"></a><span class="lineno">  677</span><span class="comment">   *</span></div>
<div class="line"><a id="l00678" name="l00678"></a><span class="lineno">  678</span><span class="comment">   * @param log_in_rsp</span></div>
<div class="line"><a id="l00679" name="l00679"></a><span class="lineno">  679</span><span class="comment">   *        The response in-message from `struc::Channel`.</span></div>
<div class="line"><a id="l00680" name="l00680"></a><span class="lineno">  680</span><span class="comment">   * @param init_channels_by_cli_req_pre_sized</span></div>
<div class="line"><a id="l00681" name="l00681"></a><span class="lineno">  681</span><span class="comment">   *        See advanced async_connect() features.</span></div>
<div class="line"><a id="l00682" name="l00682"></a><span class="lineno">  682</span><span class="comment">   * @param mdt_from_srv_or_null</span></div>
<div class="line"><a id="l00683" name="l00683"></a><span class="lineno">  683</span><span class="comment">   *        See advanced async_connect() features.</span></div>
<div class="line"><a id="l00684" name="l00684"></a><span class="lineno">  684</span><span class="comment">   * @param init_channels_by_srv_req</span></div>
<div class="line"><a id="l00685" name="l00685"></a><span class="lineno">  685</span><span class="comment">   *        See advanced async_connect() features.</span></div>
<div class="line"><a id="l00686" name="l00686"></a><span class="lineno">  686</span><span class="comment">   */</span></div>
<div class="line"><a id="l00687" name="l00687"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a139fde1cf8dc2c64276b9eb25b35bcee">  687</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a139fde1cf8dc2c64276b9eb25b35bcee">on_master_channel_log_in_rsp</a>(<span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1transport_1_1struc_1_1Channel.html#ae1f4b316eaeb7ed520a84d9e21e21063">Master_structured_channel::Msg_in_ptr</a>&amp;&amp; log_in_rsp,</div>
<div class="line"><a id="l00688" name="l00688"></a><span class="lineno">  688</span>                                    <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_cli_req_pre_sized, <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">Mdt_reader_ptr</a>* mdt_from_srv_or_null,</div>
<div class="line"><a id="l00689" name="l00689"></a><span class="lineno">  689</span>                                    <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_srv_req);</div>
<div class="line"><a id="l00690" name="l00690"></a><span class="lineno">  690</span><span class="comment"></span> </div>
<div class="line"><a id="l00691" name="l00691"></a><span class="lineno">  691</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00692" name="l00692"></a><span class="lineno">  692</span><span class="comment">   * In thread W, handler for #m_master_channel receiving a init-channel-open message.</span></div>
<div class="line"><a id="l00693" name="l00693"></a><span class="lineno">  693</span><span class="comment">   * This is similar to on_master_channel_open_channel_req(), except:</span></div>
<div class="line"><a id="l00694" name="l00694"></a><span class="lineno">  694</span><span class="comment">   *   - It occurs in CONNECTING state, after log-in, if server is required to open init-channels</span></div>
<div class="line"><a id="l00695" name="l00695"></a><span class="lineno">  695</span><span class="comment">   *     on our behalf or its behalf or both.</span></div>
<div class="line"><a id="l00696" name="l00696"></a><span class="lineno">  696</span><span class="comment">   *   - It uses the same in-message, but it is not treated as a request; rather just a notification</span></div>
<div class="line"><a id="l00697" name="l00697"></a><span class="lineno">  697</span><span class="comment">   *     of the info regarding 1 of the requested channels...</span></div>
<div class="line"><a id="l00698" name="l00698"></a><span class="lineno">  698</span><span class="comment">   *   - ...except for the last one, which *is* treated as a request:</span></div>
<div class="line"><a id="l00699" name="l00699"></a><span class="lineno">  699</span><span class="comment">   *     - we set up the regular passive-open-channel handler (on_master_channel_open_channel_req());</span></div>
<div class="line"><a id="l00700" name="l00700"></a><span class="lineno">  700</span><span class="comment">   *     - we move to PEER state (emit to #m_conn_on_done_func_or_empty);</span></div>
<div class="line"><a id="l00701" name="l00701"></a><span class="lineno">  701</span><span class="comment">   *     - we respond with an OK; so server knows it too can move to PEER state.</span></div>
<div class="line"><a id="l00702" name="l00702"></a><span class="lineno">  702</span><span class="comment">   *       - If that `send()` fails we move to NULL instead of PEER state (still invoke on-connect-done handler).</span></div>
<div class="line"><a id="l00703" name="l00703"></a><span class="lineno">  703</span><span class="comment">   *</span></div>
<div class="line"><a id="l00704" name="l00704"></a><span class="lineno">  704</span><span class="comment">   * So this method is invoked `n_init_channels` times (assuming all goes well); and each time</span></div>
<div class="line"><a id="l00705" name="l00705"></a><span class="lineno">  705</span><span class="comment">   * `*init_channels_ptr` grows by 1 element; once it is `n_init_channels` long -- that&#39;s the last one,</span></div>
<div class="line"><a id="l00706" name="l00706"></a><span class="lineno">  706</span><span class="comment">   * and we do those last 3 sub-bullet points.</span></div>
<div class="line"><a id="l00707" name="l00707"></a><span class="lineno">  707</span><span class="comment">   *</span></div>
<div class="line"><a id="l00708" name="l00708"></a><span class="lineno">  708</span><span class="comment">   * @param open_channel_msg</span></div>
<div class="line"><a id="l00709" name="l00709"></a><span class="lineno">  709</span><span class="comment">   *        The in-message from `struc::Channel`.</span></div>
<div class="line"><a id="l00710" name="l00710"></a><span class="lineno">  710</span><span class="comment">   * @param n_init_channels</span></div>
<div class="line"><a id="l00711" name="l00711"></a><span class="lineno">  711</span><span class="comment">   *        1+, the count of clients local async_connect() requested plus same from opposing `async_accept()`.</span></div>
<div class="line"><a id="l00712" name="l00712"></a><span class="lineno">  712</span><span class="comment">   * @param init_channels_ptr</span></div>
<div class="line"><a id="l00713" name="l00713"></a><span class="lineno">  713</span><span class="comment">   *        Intermediate PEER-state #Channel_obj results list; first empty, next time with 1 elements, then 2, ....</span></div>
<div class="line"><a id="l00714" name="l00714"></a><span class="lineno">  714</span><span class="comment">   *        If `.size() == n_init_channels`, we shall move to PEER state.</span></div>
<div class="line"><a id="l00715" name="l00715"></a><span class="lineno">  715</span><span class="comment">   * @param init_channels_by_cli_req_pre_sized</span></div>
<div class="line"><a id="l00716" name="l00716"></a><span class="lineno">  716</span><span class="comment">   *        See advanced async_connect() features.</span></div>
<div class="line"><a id="l00717" name="l00717"></a><span class="lineno">  717</span><span class="comment">   * @param mdt_from_srv_or_null</span></div>
<div class="line"><a id="l00718" name="l00718"></a><span class="lineno">  718</span><span class="comment">   *        See advanced async_connect() features.</span></div>
<div class="line"><a id="l00719" name="l00719"></a><span class="lineno">  719</span><span class="comment">   * @param init_channels_by_srv_req</span></div>
<div class="line"><a id="l00720" name="l00720"></a><span class="lineno">  720</span><span class="comment">   *        See advanced async_connect() features.</span></div>
<div class="line"><a id="l00721" name="l00721"></a><span class="lineno">  721</span><span class="comment">   * @param mdt_from_srv</span></div>
<div class="line"><a id="l00722" name="l00722"></a><span class="lineno">  722</span><span class="comment">   *        Value to which to set `*mdt_from_srv_or_null`, if the latter is not null, and</span></div>
<div class="line"><a id="l00723" name="l00723"></a><span class="lineno">  723</span><span class="comment">   *        this is the last invocation of this method.</span></div>
<div class="line"><a id="l00724" name="l00724"></a><span class="lineno">  724</span><span class="comment">   */</span></div>
<div class="line"><a id="l00725" name="l00725"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ac983066e433f143cf02cd730260e6e65">  725</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#ac983066e433f143cf02cd730260e6e65">on_master_channel_init_open_channel</a></div>
<div class="line"><a id="l00726" name="l00726"></a><span class="lineno">  726</span>         (<span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1transport_1_1struc_1_1Channel.html#ae1f4b316eaeb7ed520a84d9e21e21063">Master_structured_channel::Msg_in_ptr</a>&amp;&amp; open_channel_msg,</div>
<div class="line"><a id="l00727" name="l00727"></a><span class="lineno">  727</span>          <span class="keywordtype">size_t</span> n_init_channels, <span class="keyword">const</span> boost::shared_ptr&lt;Channels&gt;&amp; init_channels_ptr,</div>
<div class="line"><a id="l00728" name="l00728"></a><span class="lineno">  728</span>          <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_cli_req_pre_sized, <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">Mdt_reader_ptr</a>* mdt_from_srv_or_null,</div>
<div class="line"><a id="l00729" name="l00729"></a><span class="lineno">  729</span>          <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_srv_req, <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">Mdt_reader_ptr</a>&amp;&amp; mdt_from_srv);</div>
<div class="line"><a id="l00730" name="l00730"></a><span class="lineno">  730</span><span class="comment"></span> </div>
<div class="line"><a id="l00731" name="l00731"></a><span class="lineno">  731</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00732" name="l00732"></a><span class="lineno">  732</span><span class="comment">   * In thread W, handler for #m_master_channel receiving a passive-open (a/k/a open-channel-to-client) request.</span></div>
<div class="line"><a id="l00733" name="l00733"></a><span class="lineno">  733</span><span class="comment">   * If there is no issue with this request, and we&#39;re able to sync-send the open-channel response to that effect,</span></div>
<div class="line"><a id="l00734" name="l00734"></a><span class="lineno">  734</span><span class="comment">   * this shall fire on-passive-open handler, giving it a new #Channel_obj in PEER state + metadata.</span></div>
<div class="line"><a id="l00735" name="l00735"></a><span class="lineno">  735</span><span class="comment">   * If there is a problem, then it&#39;s not a session-hosing situation; local user is none-the-wiser; except that</span></div>
<div class="line"><a id="l00736" name="l00736"></a><span class="lineno">  736</span><span class="comment">   * if the `send()` reveals a *new* error, then it is a session-hosing situation, and local user is informed</span></div>
<div class="line"><a id="l00737" name="l00737"></a><span class="lineno">  737</span><span class="comment">   * via on-error handler.</span></div>
<div class="line"><a id="l00738" name="l00738"></a><span class="lineno">  738</span><span class="comment">   *</span></div>
<div class="line"><a id="l00739" name="l00739"></a><span class="lineno">  739</span><span class="comment">   * @param open_channel_req</span></div>
<div class="line"><a id="l00740" name="l00740"></a><span class="lineno">  740</span><span class="comment">   *        The request in-message from `struc::Channel`.</span></div>
<div class="line"><a id="l00741" name="l00741"></a><span class="lineno">  741</span><span class="comment">   */</span></div>
<div class="line"><a id="l00742" name="l00742"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a84bcd253bb1cd89fcf94233c2f771142">  742</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a84bcd253bb1cd89fcf94233c2f771142">on_master_channel_open_channel_req</a>(<span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1transport_1_1struc_1_1Channel.html#ae1f4b316eaeb7ed520a84d9e21e21063">Master_structured_channel::Msg_in_ptr</a>&amp;&amp; open_channel_req);</div>
<div class="line"><a id="l00743" name="l00743"></a><span class="lineno">  743</span><span class="comment"></span> </div>
<div class="line"><a id="l00744" name="l00744"></a><span class="lineno">  744</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00745" name="l00745"></a><span class="lineno">  745</span><span class="comment">   * In thread W, based on resources acquired on server side, creates local #Channel_obj to emit to the user</span></div>
<div class="line"><a id="l00746" name="l00746"></a><span class="lineno">  746</span><span class="comment">   * thus completing a channel-open.  If active-open on our part, we do this upon receiving server response</span></div>
<div class="line"><a id="l00747" name="l00747"></a><span class="lineno">  747</span><span class="comment">   * to our open-channel-to-server request.  If passive-open, we do this upon receiving server&#39;s</span></div>
<div class="line"><a id="l00748" name="l00748"></a><span class="lineno">  748</span><span class="comment">   * open-channel-to-client request, before replying with our OK.  Either way the in-message from server</span></div>
<div class="line"><a id="l00749" name="l00749"></a><span class="lineno">  749</span><span class="comment">   * contained the handle(s) to the resource(s) it acquired for this channel; these are args to this method.</span></div>
<div class="line"><a id="l00750" name="l00750"></a><span class="lineno">  750</span><span class="comment">   *</span></div>
<div class="line"><a id="l00751" name="l00751"></a><span class="lineno">  751</span><span class="comment">   * @param mq_name_c2s_or_none</span></div>
<div class="line"><a id="l00752" name="l00752"></a><span class="lineno">  752</span><span class="comment">   *        If #S_MQS_ENABLED this is the (non-empty) name of the client-&gt;server unidirectional MQ for the channel.</span></div>
<div class="line"><a id="l00753" name="l00753"></a><span class="lineno">  753</span><span class="comment">   *        Else empty/ignored.</span></div>
<div class="line"><a id="l00754" name="l00754"></a><span class="lineno">  754</span><span class="comment">   * @param mq_name_s2c_or_none</span></div>
<div class="line"><a id="l00755" name="l00755"></a><span class="lineno">  755</span><span class="comment">   *        Like the preceding but opposite-direction (server-&gt;client).</span></div>
<div class="line"><a id="l00756" name="l00756"></a><span class="lineno">  756</span><span class="comment">   * @param local_hndl_or_null</span></div>
<div class="line"><a id="l00757" name="l00757"></a><span class="lineno">  757</span><span class="comment">   *        If #S_SOCKET_STREAM_ENABLED this is our pre-connected `Native_handle`; the server did `connect_pair()`</span></div>
<div class="line"><a id="l00758" name="l00758"></a><span class="lineno">  758</span><span class="comment">   *        and sent us 1/2 of the pair.  Else null/ignored.</span></div>
<div class="line"><a id="l00759" name="l00759"></a><span class="lineno">  759</span><span class="comment">   * @param opened_channel_ptr</span></div>
<div class="line"><a id="l00760" name="l00760"></a><span class="lineno">  760</span><span class="comment">   *        Target #Channel_obj we shall try to move-to PEER state.  It&#39;ll be left unmodified if</span></div>
<div class="line"><a id="l00761" name="l00761"></a><span class="lineno">  761</span><span class="comment">   *        error is emitted.</span></div>
<div class="line"><a id="l00762" name="l00762"></a><span class="lineno">  762</span><span class="comment">   * @param active_else_passive</span></div>
<div class="line"><a id="l00763" name="l00763"></a><span class="lineno">  763</span><span class="comment">   *        `true` if this is from open_channel(); `false` if from on_master_channel_open_channel_req().</span></div>
<div class="line"><a id="l00764" name="l00764"></a><span class="lineno">  764</span><span class="comment">   * @param err_code_ptr</span></div>
<div class="line"><a id="l00765" name="l00765"></a><span class="lineno">  765</span><span class="comment">   *        Non-null pointer to #Error_code; deref shall be untouched on success (and must be falsy at entry);</span></div>
<div class="line"><a id="l00766" name="l00766"></a><span class="lineno">  766</span><span class="comment">   *        else deref shall be set to reason for failure.  As of this writing the only possible path to failure</span></div>
<div class="line"><a id="l00767" name="l00767"></a><span class="lineno">  767</span><span class="comment">   *        is if #S_MQS_ENABLED, and we&#39;re unable to open an MQ handle or transport::Blob_stream_mq_sender</span></div>
<div class="line"><a id="l00768" name="l00768"></a><span class="lineno">  768</span><span class="comment">   *        or transport::Blob_stream_mq_receiver to 1 of the MQs.  This is highly unlikely, since the server</span></div>
<div class="line"><a id="l00769" name="l00769"></a><span class="lineno">  769</span><span class="comment">   *        was able to do it fine, but we leave it to caller to deal with the implications.</span></div>
<div class="line"><a id="l00770" name="l00770"></a><span class="lineno">  770</span><span class="comment">   *</span></div>
<div class="line"><a id="l00771" name="l00771"></a><span class="lineno">  771</span><span class="comment">   * @todo As of this writing the eventuality where Client_session_impl::create_channel_obj() yields an</span></div>
<div class="line"><a id="l00772" name="l00772"></a><span class="lineno">  772</span><span class="comment">   * error is treated as assertion-trip-worthy by its caller; hence consider just tripping assertion inside</span></div>
<div class="line"><a id="l00773" name="l00773"></a><span class="lineno">  773</span><span class="comment">   * instead and no out-arg.  For now it is left this way in case we&#39;d want the (internal) caller to do something</span></div>
<div class="line"><a id="l00774" name="l00774"></a><span class="lineno">  774</span><span class="comment">   * more graceful in the future, and in the meantime it&#39;s a decently reusable chunk of code to use in that alleged</span></div>
<div class="line"><a id="l00775" name="l00775"></a><span class="lineno">  775</span><span class="comment">   * contingency.</span></div>
<div class="line"><a id="l00776" name="l00776"></a><span class="lineno">  776</span><span class="comment">   */</span></div>
<div class="line"><a id="l00777" name="l00777"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a6c67f6c993089dadf16acb47d535cb68">  777</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a6c67f6c993089dadf16acb47d535cb68">create_channel_obj</a>(<span class="keyword">const</span> <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>&amp; mq_name_c2s_or_none, <span class="keyword">const</span> <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>&amp; mq_name_s2c_or_none,</div>
<div class="line"><a id="l00778" name="l00778"></a><span class="lineno">  778</span>                          <a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a>&amp;&amp; local_hndl_or_null, <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">Channel_obj</a>* opened_channel_ptr,</div>
<div class="line"><a id="l00779" name="l00779"></a><span class="lineno">  779</span>                          <span class="keywordtype">bool</span> active_else_passive, <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code_ptr);</div>
<div class="line"><a id="l00780" name="l00780"></a><span class="lineno">  780</span><span class="comment"></span> </div>
<div class="line"><a id="l00781" name="l00781"></a><span class="lineno">  781</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00782" name="l00782"></a><span class="lineno">  782</span><span class="comment">   * Little helper that invokes #m_conn_on_done_func_or_empty, passing it `err_code`, and -- per that member&#39;s</span></div>
<div class="line"><a id="l00783" name="l00783"></a><span class="lineno">  783</span><span class="comment">   * internal use semantics -- empties #m_conn_on_done_func_or_empty.  A key property is that the emptying occurs</span></div>
<div class="line"><a id="l00784" name="l00784"></a><span class="lineno">  784</span><span class="comment">   * just *before* invoking it (obviously first saving it).  This allows the handler to itself un-empty</span></div>
<div class="line"><a id="l00785" name="l00785"></a><span class="lineno">  785</span><span class="comment">   * #m_conn_on_done_func_or_empty, as required by cancel_peer_state_to_connecting() at least.  (That, in turn,</span></div>
<div class="line"><a id="l00786" name="l00786"></a><span class="lineno">  786</span><span class="comment">   * may be used by sub-classes that implement async_connect() by piggybacking onto our vanilla one.)</span></div>
<div class="line"><a id="l00787" name="l00787"></a><span class="lineno">  787</span><span class="comment">   *</span></div>
<div class="line"><a id="l00788" name="l00788"></a><span class="lineno">  788</span><span class="comment">   * #m_conn_on_done_func_or_empty must not be empty; or behavior is undefined.</span></div>
<div class="line"><a id="l00789" name="l00789"></a><span class="lineno">  789</span><span class="comment">   *</span></div>
<div class="line"><a id="l00790" name="l00790"></a><span class="lineno">  790</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00791" name="l00791"></a><span class="lineno">  791</span><span class="comment">   *        Arg to `m_conn_on_done_func_or_empty()`.</span></div>
<div class="line"><a id="l00792" name="l00792"></a><span class="lineno">  792</span><span class="comment">   */</span></div>
<div class="line"><a id="l00793" name="l00793"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a428ae010a09aae1bac509e87fd927152">  793</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Client__session__impl.html#a428ae010a09aae1bac509e87fd927152">invoke_conn_on_done_func</a>(<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; err_code);</div>
<div class="line"><a id="l00794" name="l00794"></a><span class="lineno">  794</span> </div>
<div class="line"><a id="l00795" name="l00795"></a><span class="lineno">  795</span>  <span class="comment">// Data.</span></div>
<div class="line"><a id="l00796" name="l00796"></a><span class="lineno">  796</span><span class="comment"></span> </div>
<div class="line"><a id="l00797" name="l00797"></a><span class="lineno">  797</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00798" name="l00798"></a><span class="lineno">  798</span><span class="comment">   * The current state of `*this`.  Accessed in thread W only (not protected by mutex).</span></div>
<div class="line"><a id="l00799" name="l00799"></a><span class="lineno">  799</span><span class="comment">   *</span></div>
<div class="line"><a id="l00800" name="l00800"></a><span class="lineno">  800</span><span class="comment">   * @note I (ygoldfel) considered just relying on Native_socket_stream</span></div>
<div class="line"><a id="l00801" name="l00801"></a><span class="lineno">  801</span><span class="comment">   * itself to just return `false`, and then we&#39;d forward to its state detection.  It would&#39;ve been nice,</span></div>
<div class="line"><a id="l00802" name="l00802"></a><span class="lineno">  802</span><span class="comment">   * but ultimately it just seemed a bit too sloppy and hard to reason about... I ~duplicated this here instead.</span></div>
<div class="line"><a id="l00803" name="l00803"></a><span class="lineno">  803</span><span class="comment">   */</span></div>
<div class="line"><a id="l00804" name="l00804"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a3a5f5102020adace1e898d977e929908">  804</a></span>  <a class="code hl_enumeration" href="classipc_1_1session_1_1Client__session__impl.html#af7a951bd266bdd0e3339a0fbddba9e8b">State</a> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a3a5f5102020adace1e898d977e929908">m_state</a>;</div>
<div class="line"><a id="l00805" name="l00805"></a><span class="lineno">  805</span><span class="comment"></span> </div>
<div class="line"><a id="l00806" name="l00806"></a><span class="lineno">  806</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00807" name="l00807"></a><span class="lineno">  807</span><span class="comment">   * Handles the protocol negotiation at the start of the pipe, as pertains to algorithms perpetuated by</span></div>
<div class="line"><a id="l00808" name="l00808"></a><span class="lineno">  808</span><span class="comment">   * the vanilla ipc::session `Session` hierarchy.  Reset essentially at start of each async_connect().</span></div>
<div class="line"><a id="l00809" name="l00809"></a><span class="lineno">  809</span><span class="comment">   *</span></div>
<div class="line"><a id="l00810" name="l00810"></a><span class="lineno">  810</span><span class="comment">   * Outgoing-direction state is touched when assembling `LogInReq` to send to opposing `Server_session`.</span></div>
<div class="line"><a id="l00811" name="l00811"></a><span class="lineno">  811</span><span class="comment">   * Incoming-direction state is touched/verified at the start of interpreting `LogInRsp` receiver from there.</span></div>
<div class="line"><a id="l00812" name="l00812"></a><span class="lineno">  812</span><span class="comment">   *</span></div>
<div class="line"><a id="l00813" name="l00813"></a><span class="lineno">  813</span><span class="comment">   * @see transport::Protocol_negotiator doc header for key background on the topic.</span></div>
<div class="line"><a id="l00814" name="l00814"></a><span class="lineno">  814</span><span class="comment">   */</span></div>
<div class="line"><a id="l00815" name="l00815"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ab55fdca2097f5444f35efc97a8af326b">  815</a></span>  <a class="code hl_class" href="classipc_1_1transport_1_1Protocol__negotiator.html">transport::Protocol_negotiator</a> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#ab55fdca2097f5444f35efc97a8af326b">m_protocol_negotiator</a>;</div>
<div class="line"><a id="l00816" name="l00816"></a><span class="lineno">  816</span><span class="comment"></span> </div>
<div class="line"><a id="l00817" name="l00817"></a><span class="lineno">  817</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00818" name="l00818"></a><span class="lineno">  818</span><span class="comment">   * Analogous to #m_protocol_negotiator but pertains to algorithms perpetuated by (if relevant)</span></div>
<div class="line"><a id="l00819" name="l00819"></a><span class="lineno">  819</span><span class="comment">   * non-vanilla ipc::session `Session` hierarchy implemented on top of our vanilla ipc::session `Session` hierarchy.</span></div>
<div class="line"><a id="l00820" name="l00820"></a><span class="lineno">  820</span><span class="comment">   * For example, ipc::session::shm hierarchies can use this to version whatever additional protocol is required</span></div>
<div class="line"><a id="l00821" name="l00821"></a><span class="lineno">  821</span><span class="comment">   * to establish SHM things.</span></div>
<div class="line"><a id="l00822" name="l00822"></a><span class="lineno">  822</span><span class="comment">   *</span></div>
<div class="line"><a id="l00823" name="l00823"></a><span class="lineno">  823</span><span class="comment">   * @see transport::Protocol_negotiator doc header for key background on the topic.</span></div>
<div class="line"><a id="l00824" name="l00824"></a><span class="lineno">  824</span><span class="comment">   */</span></div>
<div class="line"><a id="l00825" name="l00825"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a3c53046a113fcf1ba4c857e8d4c2fbbd">  825</a></span>  <a class="code hl_class" href="classipc_1_1transport_1_1Protocol__negotiator.html">transport::Protocol_negotiator</a> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a3c53046a113fcf1ba4c857e8d4c2fbbd">m_protocol_negotiator_aux</a>;</div>
<div class="line"><a id="l00826" name="l00826"></a><span class="lineno">  826</span><span class="comment"></span> </div>
<div class="line"><a id="l00827" name="l00827"></a><span class="lineno">  827</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00828" name="l00828"></a><span class="lineno">  828</span><span class="comment">   * The `on_done_func` argument to async_connect(); `.empty()` except while in State::S_CONNECTING state.</span></div>
<div class="line"><a id="l00829" name="l00829"></a><span class="lineno">  829</span><span class="comment">   * In other words it is assigned at entry to CONNECTING and `.clear()`ed at subsequent entry to State::S_PEER</span></div>
<div class="line"><a id="l00830" name="l00830"></a><span class="lineno">  830</span><span class="comment">   * or State::S_NULL (depending on success/failure of the connect op).</span></div>
<div class="line"><a id="l00831" name="l00831"></a><span class="lineno">  831</span><span class="comment">   */</span></div>
<div class="line"><a id="l00832" name="l00832"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#addb0e40c34f2ae44ee1252f8123c149c">  832</a></span>  flow::async::Task_asio_err <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#addb0e40c34f2ae44ee1252f8123c149c">m_conn_on_done_func_or_empty</a>;</div>
<div class="line"><a id="l00833" name="l00833"></a><span class="lineno">  833</span><span class="comment"></span> </div>
<div class="line"><a id="l00834" name="l00834"></a><span class="lineno">  834</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00835" name="l00835"></a><span class="lineno">  835</span><span class="comment">   * Logging-only `*this`-unique ID used in nicknaming the last actively-opened (via open_channel()) channel.</span></div>
<div class="line"><a id="l00836" name="l00836"></a><span class="lineno">  836</span><span class="comment">   * It is incremented each time.  Accessed in thread W only (not protected by mutex).</span></div>
<div class="line"><a id="l00837" name="l00837"></a><span class="lineno">  837</span><span class="comment">   */</span></div>
<div class="line"><a id="l00838" name="l00838"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ade1b57a26147ececddbd0234c0b63be9">  838</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#ade1b57a26147ececddbd0234c0b63be9">m_last_actively_opened_channel_id</a>;</div>
<div class="line"><a id="l00839" name="l00839"></a><span class="lineno">  839</span><span class="comment"></span> </div>
<div class="line"><a id="l00840" name="l00840"></a><span class="lineno">  840</span><span class="comment">  /// A-la #m_last_actively_opened_channel_id but for passively-opened channels (on_master_channel_open_channel_req()).</span></div>
<div class="line"><a id="l00841" name="l00841"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a89d1ce46faa61df455b6f186eb892711">  841</a></span><span class="comment"></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a89d1ce46faa61df455b6f186eb892711">m_last_passively_opened_channel_id</a>;</div>
<div class="line"><a id="l00842" name="l00842"></a><span class="lineno">  842</span><span class="comment"></span> </div>
<div class="line"><a id="l00843" name="l00843"></a><span class="lineno">  843</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00844" name="l00844"></a><span class="lineno">  844</span><span class="comment">   * Worker thread (a/k/a thread W).</span></div>
<div class="line"><a id="l00845" name="l00845"></a><span class="lineno">  845</span><span class="comment">   *</span></div>
<div class="line"><a id="l00846" name="l00846"></a><span class="lineno">  846</span><span class="comment">   * Ordering: Should be declared before #m_master_channel: It should destruct before the `Task_engine` onto which</span></div>
<div class="line"><a id="l00847" name="l00847"></a><span class="lineno">  847</span><span class="comment">   * its queued-up handlers might `post()` items destructs prematurely.</span></div>
<div class="line"><a id="l00848" name="l00848"></a><span class="lineno">  848</span><span class="comment">   *</span></div>
<div class="line"><a id="l00849" name="l00849"></a><span class="lineno">  849</span><span class="comment">   * ### Why `mutable`? ###</span></div>
<div class="line"><a id="l00850" name="l00850"></a><span class="lineno">  850</span><span class="comment">   * Well, session_token() is `const` to the user but must `.post()` which is non-`const`.  This fits the spirit</span></div>
<div class="line"><a id="l00851" name="l00851"></a><span class="lineno">  851</span><span class="comment">   * of `mutable`.  I (ygoldfel) think.</span></div>
<div class="line"><a id="l00852" name="l00852"></a><span class="lineno">  852</span><span class="comment">   */</span></div>
<div class="line"><a id="l00853" name="l00853"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ac3039c565e1da99296dfb71255129201">  853</a></span>  <span class="keyword">mutable</span> flow::async::Single_thread_task_loop <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#ac3039c565e1da99296dfb71255129201">m_async_worker</a>;</div>
<div class="line"><a id="l00854" name="l00854"></a><span class="lineno">  854</span><span class="comment"></span> </div>
<div class="line"><a id="l00855" name="l00855"></a><span class="lineno">  855</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00856" name="l00856"></a><span class="lineno">  856</span><span class="comment">   * The session master channel.  Accessed in thread W only (not protected by mutex).</span></div>
<div class="line"><a id="l00857" name="l00857"></a><span class="lineno">  857</span><span class="comment">   *   - When #m_state is NULL, this is null.</span></div>
<div class="line"><a id="l00858" name="l00858"></a><span class="lineno">  858</span><span class="comment">   *   - When #m_state is CONNECTING:</span></div>
<div class="line"><a id="l00859" name="l00859"></a><span class="lineno">  859</span><span class="comment">   *     - It is still null until transport::Native_socket_stream::sync_connect() yields a PEER-state socket.</span></div>
<div class="line"><a id="l00860" name="l00860"></a><span class="lineno">  860</span><span class="comment">   *       (This occurs, if it does occur, within a non-blocking time period upon entry to async_connect().)</span></div>
<div class="line"><a id="l00861" name="l00861"></a><span class="lineno">  861</span><span class="comment">   *     - It is not null from that point on -- including through entry to PEER -- but it *does* go back to</span></div>
<div class="line"><a id="l00862" name="l00862"></a><span class="lineno">  862</span><span class="comment">   *       null if log-in procedure fails putting `m_state = State::S_NULL` again.</span></div>
<div class="line"><a id="l00863" name="l00863"></a><span class="lineno">  863</span><span class="comment">   *   - When #m_state is PEER: It remains non-null and immutable until dtor.</span></div>
<div class="line"><a id="l00864" name="l00864"></a><span class="lineno">  864</span><span class="comment">   *</span></div>
<div class="line"><a id="l00865" name="l00865"></a><span class="lineno">  865</span><span class="comment">   * ### Rationale for above invariant ###</span></div>
<div class="line"><a id="l00866" name="l00866"></a><span class="lineno">  866</span><span class="comment">   * Generally it is a pain in the butt to deal with a `struc::Channel` being destroyed, as it has</span></div>
<div class="line"><a id="l00867" name="l00867"></a><span class="lineno">  867</span><span class="comment">   * non-boost.asio-style handler semantics wherein one must be ready for a handler for channel C to fire</span></div>
<div class="line"><a id="l00868" name="l00868"></a><span class="lineno">  868</span><span class="comment">   * in our thread W, even after we destroy C in a preceding thread W task.  So, here as in other classes,</span></div>
<div class="line"><a id="l00869" name="l00869"></a><span class="lineno">  869</span><span class="comment">   * we aim to keep it non-null and immutable once it&#39;s been constructed.  (E.g., that&#39;s the case in</span></div>
<div class="line"><a id="l00870" name="l00870"></a><span class="lineno">  870</span><span class="comment">   * Server_session_impl.)  However, since we allow async_connect() to be retried on failure, we do need to</span></div>
<div class="line"><a id="l00871" name="l00871"></a><span class="lineno">  871</span><span class="comment">   * get back to a coherent state when #m_state is NULL.  So in that case only, it is renullified.</span></div>
<div class="line"><a id="l00872" name="l00872"></a><span class="lineno">  872</span><span class="comment">   *</span></div>
<div class="line"><a id="l00873" name="l00873"></a><span class="lineno">  873</span><span class="comment">   * Because it is renullified, there&#39;s the &quot;observer&quot; thing used in on_master_channel_error() to deal with it.</span></div>
<div class="line"><a id="l00874" name="l00874"></a><span class="lineno">  874</span><span class="comment">   * It&#39;s a fairly small section of code though.</span></div>
<div class="line"><a id="l00875" name="l00875"></a><span class="lineno">  875</span><span class="comment">   */</span></div>
<div class="line"><a id="l00876" name="l00876"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a3acf3432c3806476fc20e951d0790949">  876</a></span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad432ab4e95ddcfd0396d5ea821dec15c">Master_structured_channel_ptr</a> <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#a3acf3432c3806476fc20e951d0790949">m_master_channel</a>;</div>
<div class="line"><a id="l00877" name="l00877"></a><span class="lineno">  877</span><span class="comment"></span> </div>
<div class="line"><a id="l00878" name="l00878"></a><span class="lineno">  878</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00879" name="l00879"></a><span class="lineno">  879</span><span class="comment">   * Null until PEER state is reached, and NULL unless compile-time #S_GRACEFUL_FINISH_REQUIRED is `true`,</span></div>
<div class="line"><a id="l00880" name="l00880"></a><span class="lineno">  880</span><span class="comment">   * this is used to block at the start of dtor to synchronize with the opposing `Session` dtor for safety.</span></div>
<div class="line"><a id="l00881" name="l00881"></a><span class="lineno">  881</span><span class="comment">   *</span></div>
<div class="line"><a id="l00882" name="l00882"></a><span class="lineno">  882</span><span class="comment">   * @see Session_base::Graceful_finisher doc header for all the background ever.</span></div>
<div class="line"><a id="l00883" name="l00883"></a><span class="lineno">  883</span><span class="comment">   */</span></div>
<div class="line"><a id="l00884" name="l00884"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#abba4e0890f2d40b0f0cd76ecface739f">  884</a></span>  std::optional&lt;typename Base::Graceful_finisher&gt; <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#abba4e0890f2d40b0f0cd76ecface739f">m_graceful_finisher</a>;</div>
<div class="line"><a id="l00885" name="l00885"></a><span class="lineno">  885</span>}; <span class="comment">// class Client_session_impl</span></div>
<div class="line"><a id="l00886" name="l00886"></a><span class="lineno">  886</span> </div>
<div class="line"><a id="l00887" name="l00887"></a><span class="lineno">  887</span><span class="comment">// Free functions: in *_fwd.hpp.</span></div>
<div class="line"><a id="l00888" name="l00888"></a><span class="lineno">  888</span> </div>
<div class="line"><a id="l00889" name="l00889"></a><span class="lineno">  889</span><span class="comment">// Template implementations.</span></div>
<div class="line"><a id="l00890" name="l00890"></a><span class="lineno">  890</span><span class="comment"></span> </div>
<div class="line"><a id="l00891" name="l00891"></a><span class="lineno">  891</span><span class="comment">/// Internally used macro; public API users should disregard (same deal as in struc/channel.hpp).</span></div>
<div class="line"><a id="l00892" name="l00892"></a><span class="lineno"><a class="line" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">  892</a></span><span class="comment"></span><span class="preprocessor">#define TEMPLATE_CLI_SESSION_IMPL \</span></div>
<div class="line"><a id="l00893" name="l00893"></a><span class="lineno">  893</span><span class="preprocessor">  template&lt;schema::MqType S_MQ_TYPE_OR_NONE, bool S_TRANSMIT_NATIVE_HANDLES, typename Mdt_payload, \</span></div>
<div class="line"><a id="l00894" name="l00894"></a><span class="lineno">  894</span><span class="preprocessor">           schema::ShmType S_SHM_TYPE_OR_NONE, bool S_GRACEFUL_FINISH_REQUIRED_V&gt;</span><span class="comment"></span></div>
<div class="line"><a id="l00895" name="l00895"></a><span class="lineno">  895</span><span class="comment">/// Internally used macro; public API users should disregard (same deal as in struc/channel.hpp).</span></div>
<div class="line"><a id="l00896" name="l00896"></a><span class="lineno"><a class="line" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a2442fdb91128ae6d1a2bbacc7fd03c9b">  896</a></span><span class="comment"></span><span class="preprocessor">#define CLASS_CLI_SESSION_IMPL \</span></div>
<div class="line"><a id="l00897" name="l00897"></a><span class="lineno">  897</span><span class="preprocessor">  Client_session_impl&lt;S_MQ_TYPE_OR_NONE, S_TRANSMIT_NATIVE_HANDLES, Mdt_payload, \</span></div>
<div class="line"><a id="l00898" name="l00898"></a><span class="lineno">  898</span><span class="preprocessor">                      S_SHM_TYPE_OR_NONE, S_GRACEFUL_FINISH_REQUIRED_V&gt;</span></div>
<div class="line"><a id="l00899" name="l00899"></a><span class="lineno">  899</span> </div>
<div class="line"><a id="l00900" name="l00900"></a><span class="lineno">  900</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l00901" name="l00901"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aeaf64876702dffaab7441e3006195134">  901</a></span>CLASS_CLI_SESSION_IMPL::Client_session_impl(flow::log::Logger* logger_ptr,</div>
<div class="line"><a id="l00902" name="l00902"></a><span class="lineno">  902</span>                                            <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>&amp; cli_app_ref, <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__app.html">Server_app</a>&amp; srv_app_ref,</div>
<div class="line"><a id="l00903" name="l00903"></a><span class="lineno">  903</span>                                            flow::async::Task_asio_err&amp;&amp; on_err_func,</div>
<div class="line"><a id="l00904" name="l00904"></a><span class="lineno">  904</span>                                            <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad6624a4b1f7fd6e24bdde50b323b8f97">On_passive_open_channel_func</a>&amp;&amp;</div>
<div class="line"><a id="l00905" name="l00905"></a><span class="lineno">  905</span>                                              on_passive_open_channel_func_or_empty_arg,</div>
<div class="line"><a id="l00906" name="l00906"></a><span class="lineno">  906</span>                                            std::nullptr_t) :</div>
<div class="line"><a id="l00907" name="l00907"></a><span class="lineno">  907</span>  <a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Base</a>(cli_app_ref, srv_app_ref, std::move(on_err_func), std::move(on_passive_open_channel_func_or_empty_arg)),</div>
<div class="line"><a id="l00908" name="l00908"></a><span class="lineno">  908</span> </div>
<div class="line"><a id="l00909" name="l00909"></a><span class="lineno">  909</span>  flow::log::Log_context(logger_ptr, <a class="code hl_enumeration" href="namespaceipc.html#a4ccdeed058222c635745a4dc830e99f7">Log_component</a>::S_SESSION),</div>
<div class="line"><a id="l00910" name="l00910"></a><span class="lineno">  910</span> </div>
<div class="line"><a id="l00911" name="l00911"></a><span class="lineno">  911</span>  m_state(<a class="code hl_enumeration" href="classipc_1_1session_1_1Client__session__impl.html#af7a951bd266bdd0e3339a0fbddba9e8b">State</a>::S_NULL),</div>
<div class="line"><a id="l00912" name="l00912"></a><span class="lineno">  912</span> </div>
<div class="line"><a id="l00913" name="l00913"></a><span class="lineno">  913</span>  <span class="comment">/* Initial protocol = 1!</span></div>
<div class="line"><a id="l00914" name="l00914"></a><span class="lineno">  914</span><span class="comment">   * @todo This will get quite a bit more complex, especially for m_protocol_negotiator_aux,</span></div>
<div class="line"><a id="l00915" name="l00915"></a><span class="lineno">  915</span><span class="comment">   *       once at least one relevant protocol gains a version 2.  See class doc header for discussion. */</span></div>
<div class="line"><a id="l00916" name="l00916"></a><span class="lineno">  916</span>  m_protocol_negotiator(get_logger(), flow::util::ostream_op_string(<span class="stringliteral">&quot;cli-sess-&quot;</span>, *this), 1, 1),</div>
<div class="line"><a id="l00917" name="l00917"></a><span class="lineno">  917</span>  m_protocol_negotiator_aux(get_logger(), flow::util::ostream_op_string(<span class="stringliteral">&quot;cli-sess-aux-&quot;</span>, *this), 1, 1),</div>
<div class="line"><a id="l00918" name="l00918"></a><span class="lineno">  918</span> </div>
<div class="line"><a id="l00919" name="l00919"></a><span class="lineno">  919</span>  m_last_actively_opened_channel_id(0),</div>
<div class="line"><a id="l00920" name="l00920"></a><span class="lineno">  920</span>  m_last_passively_opened_channel_id(0),</div>
<div class="line"><a id="l00921" name="l00921"></a><span class="lineno">  921</span>  m_async_worker(get_logger(),</div>
<div class="line"><a id="l00922" name="l00922"></a><span class="lineno">  922</span>                 <span class="comment">/* (Linux) OS thread name will truncate the &quot;srv&lt;cli&quot; names snippet to 15-5=10 chars here;</span></div>
<div class="line"><a id="l00923" name="l00923"></a><span class="lineno">  923</span><span class="comment">                  * something decently-useful will probably get cut-off; so try to put the key parts up-front:</span></div>
<div class="line"><a id="l00924" name="l00924"></a><span class="lineno">  924</span><span class="comment">                  * that we&#39;re part of a session::Client_session impl; and the SHM type or none (0) (perhaps</span></div>
<div class="line"><a id="l00925" name="l00925"></a><span class="lineno">  925</span><span class="comment">                  * the distinction between &quot;none&quot; and &quot;yes, SHM-enabled&quot; is the useful part in most cases).</span></div>
<div class="line"><a id="l00926" name="l00926"></a><span class="lineno">  926</span><span class="comment">                  * After that in non-exotic setups our cli-name is pretty much known anyway, while targeting</span></div>
<div class="line"><a id="l00927" name="l00927"></a><span class="lineno">  927</span><span class="comment">                  * 2+ server-apps isn&#39;t that crazy and an official use-case; so put srv-name first. */</span></div>
<div class="line"><a id="l00928" name="l00928"></a><span class="lineno">  928</span>                 flow::util::ostream_op_string(<span class="stringliteral">&quot;ClS&quot;</span>, int(S_SHM_TYPE), <span class="stringliteral">&#39;-&#39;</span>,</div>
<div class="line"><a id="l00929" name="l00929"></a><span class="lineno">  929</span>                                               srv_app_ref.m_name, <span class="stringliteral">&#39;&lt;&#39;</span>, cli_app_ref.m_name))</div>
<div class="line"><a id="l00930" name="l00930"></a><span class="lineno">  930</span>{</div>
<div class="line"><a id="l00931" name="l00931"></a><span class="lineno">  931</span>  <span class="comment">// INFO level would&#39;ve been okay, but let&#39;s just save it for async_connect() which is likely coming soon.</span></div>
<div class="line"><a id="l00932" name="l00932"></a><span class="lineno">  932</span>  FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Created.  The session-connect attempt not yet requested.  &quot;</span></div>
<div class="line"><a id="l00933" name="l00933"></a><span class="lineno">  933</span>                 <span class="stringliteral">&quot;Worker thread starting, will idle until session-connect.&quot;</span>);</div>
<div class="line"><a id="l00934" name="l00934"></a><span class="lineno">  934</span>  <a class="code hl_variable" href="classipc_1_1session_1_1Client__session__impl.html#ac3039c565e1da99296dfb71255129201">m_async_worker</a>.start(flow::async::reset_this_thread_pinning);</div>
<div class="line"><a id="l00935" name="l00935"></a><span class="lineno">  935</span>  <span class="comment">// Don&#39;t inherit any strange core-affinity!  ^-- Worker must float free.</span></div>
<div class="line"><a id="l00936" name="l00936"></a><span class="lineno">  936</span>}</div>
<div class="line"><a id="l00937" name="l00937"></a><span class="lineno">  937</span> </div>
<div class="line"><a id="l00938" name="l00938"></a><span class="lineno">  938</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l00939" name="l00939"></a><span class="lineno">  939</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> On_passive_open_channel_handler, <span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l00940" name="l00940"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a8fe80ed65e416a2d1fcadb045dac0fcf">  940</a></span>CLASS_CLI_SESSION_IMPL::Client_session_impl(flow::log::Logger* logger_ptr,</div>
<div class="line"><a id="l00941" name="l00941"></a><span class="lineno">  941</span>                                            <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>&amp; cli_app_ref, <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__app.html">Server_app</a>&amp; srv_app_ref,</div>
<div class="line"><a id="l00942" name="l00942"></a><span class="lineno">  942</span>                                            Task_err&amp;&amp; on_err_func,</div>
<div class="line"><a id="l00943" name="l00943"></a><span class="lineno">  943</span>                                            On_passive_open_channel_handler&amp;&amp; on_passive_open_channel_func) :</div>
<div class="line"><a id="l00944" name="l00944"></a><span class="lineno">  944</span>  <a class="code hl_class" href="classipc_1_1session_1_1Client__session__impl.html">Client_session_impl</a>(logger_ptr, cli_app_ref, srv_app_ref,</div>
<div class="line"><a id="l00945" name="l00945"></a><span class="lineno">  945</span>                      flow::async::Task_asio_err(std::move(on_err_func)),</div>
<div class="line"><a id="l00946" name="l00946"></a><span class="lineno">  946</span>                      <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad6624a4b1f7fd6e24bdde50b323b8f97">On_passive_open_channel_func</a>(std::move(on_passive_open_channel_func)), nullptr)</div>
<div class="line"><a id="l00947" name="l00947"></a><span class="lineno">  947</span>{</div>
<div class="line"><a id="l00948" name="l00948"></a><span class="lineno">  948</span>  <span class="comment">// Delegated.</span></div>
<div class="line"><a id="l00949" name="l00949"></a><span class="lineno">  949</span>}</div>
<div class="line"><a id="l00950" name="l00950"></a><span class="lineno">  950</span> </div>
<div class="line"><a id="l00951" name="l00951"></a><span class="lineno">  951</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l00952" name="l00952"></a><span class="lineno">  952</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l00953" name="l00953"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a0edcc39889b5f68492eb9156dc7a9b7a">  953</a></span>CLASS_CLI_SESSION_IMPL::Client_session_impl(flow::log::Logger* logger_ptr,</div>
<div class="line"><a id="l00954" name="l00954"></a><span class="lineno">  954</span>                                            <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>&amp; cli_app_ref, <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__app.html">Server_app</a>&amp; srv_app_ref,</div>
<div class="line"><a id="l00955" name="l00955"></a><span class="lineno">  955</span>                                            Task_err&amp;&amp; on_err_func) :</div>
<div class="line"><a id="l00956" name="l00956"></a><span class="lineno">  956</span>  <a class="code hl_class" href="classipc_1_1session_1_1Client__session__impl.html">Client_session_impl</a>(logger_ptr, cli_app_ref, srv_app_ref,</div>
<div class="line"><a id="l00957" name="l00957"></a><span class="lineno">  957</span>                      flow::async::Task_asio_err(std::move(on_err_func)),</div>
<div class="line"><a id="l00958" name="l00958"></a><span class="lineno">  958</span>                      <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad6624a4b1f7fd6e24bdde50b323b8f97">On_passive_open_channel_func</a>(), nullptr)</div>
<div class="line"><a id="l00959" name="l00959"></a><span class="lineno">  959</span>{</div>
<div class="line"><a id="l00960" name="l00960"></a><span class="lineno">  960</span>  <span class="comment">// Delegated.</span></div>
<div class="line"><a id="l00961" name="l00961"></a><span class="lineno">  961</span>}</div>
<div class="line"><a id="l00962" name="l00962"></a><span class="lineno">  962</span> </div>
<div class="line"><a id="l00963" name="l00963"></a><span class="lineno">  963</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l00964" name="l00964"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#afb09c3a23b7e63938b9a494cec6e769b">  964</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::dtor_async_worker_stop()</div>
<div class="line"><a id="l00965" name="l00965"></a><span class="lineno">  965</span>{</div>
<div class="line"><a id="l00966" name="l00966"></a><span class="lineno">  966</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l00967" name="l00967"></a><span class="lineno">  967</span>  <span class="keyword">using </span>boost::promise;</div>
<div class="line"><a id="l00968" name="l00968"></a><span class="lineno">  968</span> </div>
<div class="line"><a id="l00969" name="l00969"></a><span class="lineno">  969</span>  <span class="comment">// We are in thread U (from either our own dtor or subclass dtor).</span></div>
<div class="line"><a id="l00970" name="l00970"></a><span class="lineno">  970</span> </div>
<div class="line"><a id="l00971" name="l00971"></a><span class="lineno">  971</span>  assert((!m_async_worker.task_engine()-&gt;stopped()) &amp;&amp; <span class="stringliteral">&quot;This shall be called at most once.&quot;</span>);</div>
<div class="line"><a id="l00972" name="l00972"></a><span class="lineno">  972</span> </div>
<div class="line"><a id="l00973" name="l00973"></a><span class="lineno">  973</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Shutting down.  Worker thread will be joined, but first &quot;</span></div>
<div class="line"><a id="l00974" name="l00974"></a><span class="lineno">  974</span>                <span class="stringliteral">&quot;we perform session master channel end-sending op (flush outgoing data) until completion.  &quot;</span></div>
<div class="line"><a id="l00975" name="l00975"></a><span class="lineno">  975</span>                <span class="stringliteral">&quot;This is generally recommended at EOL of any struc::Channel, on error or otherwise.  &quot;</span></div>
<div class="line"><a id="l00976" name="l00976"></a><span class="lineno">  976</span>                <span class="stringliteral">&quot;This is technically blocking but unlikely to take long.  Also a Graceful_finisher phase may &quot;</span></div>
<div class="line"><a id="l00977" name="l00977"></a><span class="lineno">  977</span>                <span class="stringliteral">&quot;precede the above steps (it will log if so).&quot;</span>);</div>
<div class="line"><a id="l00978" name="l00978"></a><span class="lineno">  978</span> </div>
<div class="line"><a id="l00979" name="l00979"></a><span class="lineno">  979</span>  <span class="comment">// See Session_base::Graceful_finisher doc header for all the background ever.  Also: it logs as needed.</span></div>
<div class="line"><a id="l00980" name="l00980"></a><span class="lineno">  980</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_GRACEFUL_FINISH_REQUIRED)</div>
<div class="line"><a id="l00981" name="l00981"></a><span class="lineno">  981</span>  {</div>
<div class="line"><a id="l00982" name="l00982"></a><span class="lineno">  982</span>    <span class="keyword">typename</span> <a class="code hl_class" href="classipc_1_1session_1_1Session__base_1_1Graceful__finisher.html">Base::Graceful_finisher</a>* graceful_finisher_or_null = {};</div>
<div class="line"><a id="l00983" name="l00983"></a><span class="lineno">  983</span>    m_async_worker.post([&amp;]() <span class="comment">// Have to access m_graceful_finisher (the optional&lt;&gt;) in thread W only.</span></div>
<div class="line"><a id="l00984" name="l00984"></a><span class="lineno">  984</span>    {</div>
<div class="line"><a id="l00985" name="l00985"></a><span class="lineno">  985</span>      <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00986" name="l00986"></a><span class="lineno">  986</span>      <span class="keywordflow">if</span> (m_graceful_finisher)</div>
<div class="line"><a id="l00987" name="l00987"></a><span class="lineno">  987</span>      {</div>
<div class="line"><a id="l00988" name="l00988"></a><span class="lineno">  988</span>        graceful_finisher_or_null = &amp;(m_graceful_finisher.value());</div>
<div class="line"><a id="l00989" name="l00989"></a><span class="lineno">  989</span>      }</div>
<div class="line"><a id="l00990" name="l00990"></a><span class="lineno">  990</span>    }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION); <span class="comment">// m_async_worker.post()</span></div>
<div class="line"><a id="l00991" name="l00991"></a><span class="lineno">  991</span> </div>
<div class="line"><a id="l00992" name="l00992"></a><span class="lineno">  992</span>    <span class="comment">/* If graceful_finisher_or_null is not null, then we&#39;re definitely in PEER state, and this is irreversible;</span></div>
<div class="line"><a id="l00993" name="l00993"></a><span class="lineno">  993</span><span class="comment">     * so it&#39;s cool to -&gt;on_dtor_start() on it.  It&#39;ll block as needed, etc.</span></div>
<div class="line"><a id="l00994" name="l00994"></a><span class="lineno">  994</span><span class="comment">     *</span></div>
<div class="line"><a id="l00995" name="l00995"></a><span class="lineno">  995</span><span class="comment">     * If it *is* null:</span></div>
<div class="line"><a id="l00996" name="l00996"></a><span class="lineno">  996</span><span class="comment">     *   - If between the assignment above to null and the next statement, m_graceful_finisher did not become</span></div>
<div class="line"><a id="l00997" name="l00997"></a><span class="lineno">  997</span><span class="comment">     *     non-empty, then there&#39;s no controversy: It&#39;s still not in PEER state; and there&#39;s no reason to</span></div>
<div class="line"><a id="l00998" name="l00998"></a><span class="lineno">  998</span><span class="comment">     *     block dtor still.  So no need to do anything, and that&#39;s correct.  Can just continue.</span></div>
<div class="line"><a id="l00999" name="l00999"></a><span class="lineno">  999</span><span class="comment">     *   - If however -- unlikely but possible -- in the last few microseconds (or w/e) indeed m_graceful_finisher</span></div>
<div class="line"><a id="l01000" name="l01000"></a><span class="lineno"> 1000</span><span class="comment">     *     has become non-empty, then now *this is in PEER state.  Yet we still forego any -&gt;on_dtor_start()</span></div>
<div class="line"><a id="l01001" name="l01001"></a><span class="lineno"> 1001</span><span class="comment">     *     and just continue.  Is that wrong?  No: We are in dtor; and the changeover to PEER happened in dtor;</span></div>
<div class="line"><a id="l01002" name="l01002"></a><span class="lineno"> 1002</span><span class="comment">     *     so user has had no chance to grab any resources (like borrowing SHM objects) that would need to</span></div>
<div class="line"><a id="l01003" name="l01003"></a><span class="lineno"> 1003</span><span class="comment">     *     be released before dtor can really-destroy *this (like its SHM arena).  So it&#39;s still correct to just</span></div>
<div class="line"><a id="l01004" name="l01004"></a><span class="lineno"> 1004</span><span class="comment">     *     continue. */</span></div>
<div class="line"><a id="l01005" name="l01005"></a><span class="lineno"> 1005</span>    <span class="keywordflow">if</span> (graceful_finisher_or_null)</div>
<div class="line"><a id="l01006" name="l01006"></a><span class="lineno"> 1006</span>    {</div>
<div class="line"><a id="l01007" name="l01007"></a><span class="lineno"> 1007</span>      graceful_finisher_or_null-&gt;<a class="code hl_function" href="classipc_1_1session_1_1Session__base_1_1Graceful__finisher.html#af441f45ce1ed7b890c3ab77d959f8830">on_dtor_start</a>();</div>
<div class="line"><a id="l01008" name="l01008"></a><span class="lineno"> 1008</span>      <span class="comment">// OK, now safe (or as safe as we can guarantee) to blow *this&#39;s various parts away.</span></div>
<div class="line"><a id="l01009" name="l01009"></a><span class="lineno"> 1009</span>    }</div>
<div class="line"><a id="l01010" name="l01010"></a><span class="lineno"> 1010</span>  } <span class="comment">// if constexpr(S_GRACEFUL_FINISH_REQUIRED)</span></div>
<div class="line"><a id="l01011" name="l01011"></a><span class="lineno"> 1011</span> </div>
<div class="line"><a id="l01012" name="l01012"></a><span class="lineno"> 1012</span>  <span class="comment">/* @todo Consider adding blocking struc::Channel::sync_end_sending(), possibly with timeout.  There might be</span></div>
<div class="line"><a id="l01013" name="l01013"></a><span class="lineno"> 1013</span><span class="comment">   * a to-do in its or async_end_sending() class doc header.  Timeout would help us avoid blocking here, unlikely though</span></div>
<div class="line"><a id="l01014" name="l01014"></a><span class="lineno"> 1014</span><span class="comment">   * it is in practice probably.  A sync_ call(), regardless of that, would just be convenient resulting in less</span></div>
<div class="line"><a id="l01015" name="l01015"></a><span class="lineno"> 1015</span><span class="comment">   * code here. */</span></div>
<div class="line"><a id="l01016" name="l01016"></a><span class="lineno"> 1016</span> </div>
<div class="line"><a id="l01017" name="l01017"></a><span class="lineno"> 1017</span>  <span class="comment">/* Let&#39;s do the async_end_sending() thing we just promised.</span></div>
<div class="line"><a id="l01018" name="l01018"></a><span class="lineno"> 1018</span><span class="comment">   *</span></div>
<div class="line"><a id="l01019" name="l01019"></a><span class="lineno"> 1019</span><span class="comment">   * So far everything is still operating; so we need to follow normal rules.  m_master_channel access requires</span></div>
<div class="line"><a id="l01020" name="l01020"></a><span class="lineno"> 1020</span><span class="comment">   * being in thread W. */</span></div>
<div class="line"><a id="l01021" name="l01021"></a><span class="lineno"> 1021</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l01022" name="l01022"></a><span class="lineno"> 1022</span>  {</div>
<div class="line"><a id="l01023" name="l01023"></a><span class="lineno"> 1023</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01024" name="l01024"></a><span class="lineno"> 1024</span> </div>
<div class="line"><a id="l01025" name="l01025"></a><span class="lineno"> 1025</span>    <span class="keywordflow">if</span> (!m_master_channel)</div>
<div class="line"><a id="l01026" name="l01026"></a><span class="lineno"> 1026</span>    {</div>
<div class="line"><a id="l01027" name="l01027"></a><span class="lineno"> 1027</span>      <span class="keywordflow">return</span>; <span class="comment">// Nothing to worry about; async_connect() hasn&#39;t even made this yet (or was not invoked).</span></div>
<div class="line"><a id="l01028" name="l01028"></a><span class="lineno"> 1028</span>    }</div>
<div class="line"><a id="l01029" name="l01029"></a><span class="lineno"> 1029</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l01030" name="l01030"></a><span class="lineno"> 1030</span> </div>
<div class="line"><a id="l01031" name="l01031"></a><span class="lineno"> 1031</span>    promise&lt;void&gt; done_promise;</div>
<div class="line"><a id="l01032" name="l01032"></a><span class="lineno"> 1032</span>    m_master_channel-&gt;async_end_sending([&amp;](<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp;)</div>
<div class="line"><a id="l01033" name="l01033"></a><span class="lineno"> 1033</span>    {</div>
<div class="line"><a id="l01034" name="l01034"></a><span class="lineno"> 1034</span>      <span class="comment">// We are in thread Wc (unspecified, really struc::Channel async callback thread).</span></div>
<div class="line"><a id="l01035" name="l01035"></a><span class="lineno"> 1035</span>      FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Shutdown: master channel outgoing-direction flush finished.&quot;</span>);</div>
<div class="line"><a id="l01036" name="l01036"></a><span class="lineno"> 1036</span>      done_promise.set_value();</div>
<div class="line"><a id="l01037" name="l01037"></a><span class="lineno"> 1037</span>    });</div>
<div class="line"><a id="l01038" name="l01038"></a><span class="lineno"> 1038</span>    <span class="comment">// Back here in thread W:</span></div>
<div class="line"><a id="l01039" name="l01039"></a><span class="lineno"> 1039</span>    done_promise.get_future().wait();</div>
<div class="line"><a id="l01040" name="l01040"></a><span class="lineno"> 1040</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION); <span class="comment">// m_async_worker.post()</span></div>
<div class="line"><a id="l01041" name="l01041"></a><span class="lineno"> 1041</span>  <span class="comment">// Back here in thread U: done; yay.</span></div>
<div class="line"><a id="l01042" name="l01042"></a><span class="lineno"> 1042</span> </div>
<div class="line"><a id="l01043" name="l01043"></a><span class="lineno"> 1043</span>  <span class="comment">/* This (1) stop()s the Task_engine thus possibly preventing any more handlers from running at all (any handler</span></div>
<div class="line"><a id="l01044" name="l01044"></a><span class="lineno"> 1044</span><span class="comment">   * possibly running now is the last one to run); (2) at that point Task_engine::run() exits, hence thread W exits;</span></div>
<div class="line"><a id="l01045" name="l01045"></a><span class="lineno"> 1045</span><span class="comment">   * (3) joins thread W (waits for it to exit); (4) returns.  That&#39;s a lot, but it&#39;s non-blocking. */</span></div>
<div class="line"><a id="l01046" name="l01046"></a><span class="lineno"> 1046</span>  m_async_worker.stop();</div>
<div class="line"><a id="l01047" name="l01047"></a><span class="lineno"> 1047</span>  <span class="comment">// Thread W is (synchronously!) no more.  We can now access whatever m_ state we want without concurrency concerns.</span></div>
<div class="line"><a id="l01048" name="l01048"></a><span class="lineno"> 1048</span>} <span class="comment">// Client_session_impl::dtor_async_worker_stop()</span></div>
<div class="line"><a id="l01049" name="l01049"></a><span class="lineno"> 1049</span> </div>
<div class="line"><a id="l01050" name="l01050"></a><span class="lineno"> 1050</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01051" name="l01051"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aa12539a1a446cffb097f70cba8166088"> 1051</a></span>CLASS_CLI_SESSION_IMPL::~Client_session_impl()</div>
<div class="line"><a id="l01052" name="l01052"></a><span class="lineno"> 1052</span>{</div>
<div class="line"><a id="l01053" name="l01053"></a><span class="lineno"> 1053</span>  <span class="comment">// We are in thread U.  By contract in doc header, they must not call us from a completion handler (thread W).</span></div>
<div class="line"><a id="l01054" name="l01054"></a><span class="lineno"> 1054</span> </div>
<div class="line"><a id="l01055" name="l01055"></a><span class="lineno"> 1055</span>  <span class="keywordflow">if</span> (!m_async_worker.task_engine()-&gt;stopped())</div>
<div class="line"><a id="l01056" name="l01056"></a><span class="lineno"> 1056</span>  {</div>
<div class="line"><a id="l01057" name="l01057"></a><span class="lineno"> 1057</span>    dtor_async_worker_stop();</div>
<div class="line"><a id="l01058" name="l01058"></a><span class="lineno"> 1058</span>  }</div>
<div class="line"><a id="l01059" name="l01059"></a><span class="lineno"> 1059</span> </div>
<div class="line"><a id="l01060" name="l01060"></a><span class="lineno"> 1060</span>  assert(m_conn_on_done_func_or_empty.empty()</div>
<div class="line"><a id="l01061" name="l01061"></a><span class="lineno"> 1061</span>         &amp;&amp; <span class="stringliteral">&quot;async_connect() is used internally from sync_connect() only at this time, so this should be cleared.&quot;</span>);</div>
<div class="line"><a id="l01062" name="l01062"></a><span class="lineno"> 1062</span>  <span class="comment">/* Maintenance note:</span></div>
<div class="line"><a id="l01063" name="l01063"></a><span class="lineno"> 1063</span><span class="comment">   * Please see &quot;CONNECTING state and asynchronicity&quot; in class doc header for key background.</span></div>
<div class="line"><a id="l01064" name="l01064"></a><span class="lineno"> 1064</span><span class="comment">   * As noted there, when/if some form of `*this` becomes network-enabled, async_connect() would probably become</span></div>
<div class="line"><a id="l01065" name="l01065"></a><span class="lineno"> 1065</span><span class="comment">   * a public API that could take blocking amount of time; and if during that time user invokes this dtor, then</span></div>
<div class="line"><a id="l01066" name="l01066"></a><span class="lineno"> 1066</span><span class="comment">   * we would here do our usual thing of creating a one-off thread and triggering m_conn_on_done_func_or_empty</span></div>
<div class="line"><a id="l01067" name="l01067"></a><span class="lineno"> 1067</span><span class="comment">   * with an operation-aborted error code. */</span></div>
<div class="line"><a id="l01068" name="l01068"></a><span class="lineno"> 1068</span>} <span class="comment">// Client_session_impl::~Client_session_impl()</span></div>
<div class="line"><a id="l01069" name="l01069"></a><span class="lineno"> 1069</span> </div>
<div class="line"><a id="l01070" name="l01070"></a><span class="lineno"> 1070</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01071" name="l01071"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aaf622f5f111ffa95d4ec6c636cfddb4a"> 1071</a></span><span class="keywordtype">bool</span> CLASS_CLI_SESSION_IMPL::sync_connect(<a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code)</div>
<div class="line"><a id="l01072" name="l01072"></a><span class="lineno"> 1072</span>{</div>
<div class="line"><a id="l01073" name="l01073"></a><span class="lineno"> 1073</span>  <span class="keywordflow">return</span> sync_connect(mdt_builder(), <span class="keyword">nullptr</span>, <span class="keyword">nullptr</span>, <span class="keyword">nullptr</span>, err_code);</div>
<div class="line"><a id="l01074" name="l01074"></a><span class="lineno"> 1074</span>}</div>
<div class="line"><a id="l01075" name="l01075"></a><span class="lineno"> 1075</span> </div>
<div class="line"><a id="l01076" name="l01076"></a><span class="lineno"> 1076</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01077" name="l01077"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aa60d7f50f9a9bec95c627778f1556be0"> 1077</a></span><span class="keywordtype">bool</span> CLASS_CLI_SESSION_IMPL::sync_connect(<span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a9d93e6080abf3b0827b97e084f5e8356">Mdt_builder_ptr</a>&amp; mdt,</div>
<div class="line"><a id="l01078" name="l01078"></a><span class="lineno"> 1078</span>                                          <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a>* init_channels_by_cli_req_pre_sized,</div>
<div class="line"><a id="l01079" name="l01079"></a><span class="lineno"> 1079</span>                                          <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a>* mdt_from_srv_or_null,</div>
<div class="line"><a id="l01080" name="l01080"></a><span class="lineno"> 1080</span>                                          <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a>* init_channels_by_srv_req,</div>
<div class="line"><a id="l01081" name="l01081"></a><span class="lineno"> 1081</span>                                          <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code)</div>
<div class="line"><a id="l01082" name="l01082"></a><span class="lineno"> 1082</span>{</div>
<div class="line"><a id="l01083" name="l01083"></a><span class="lineno"> 1083</span>  <span class="keyword">using </span>flow::async::Task_asio_err;</div>
<div class="line"><a id="l01084" name="l01084"></a><span class="lineno"> 1084</span> </div>
<div class="line"><a id="l01085" name="l01085"></a><span class="lineno"> 1085</span>  <a class="code hl_typedef" href="namespaceipc.html#aa455c7f045059736578ca275fc1a851f">Function</a>&lt;bool (Task_asio_err&amp;&amp;)&gt; async_connect_impl_func = [&amp;](Task_asio_err&amp;&amp; on_done_func) -&gt; <span class="keywordtype">bool</span></div>
<div class="line"><a id="l01086" name="l01086"></a><span class="lineno"> 1086</span>  {</div>
<div class="line"><a id="l01087" name="l01087"></a><span class="lineno"> 1087</span>    <span class="keywordflow">return</span> async_connect(mdt, init_channels_by_cli_req_pre_sized, mdt_from_srv_or_null, init_channels_by_srv_req,</div>
<div class="line"><a id="l01088" name="l01088"></a><span class="lineno"> 1088</span>                         std::move(on_done_func));</div>
<div class="line"><a id="l01089" name="l01089"></a><span class="lineno"> 1089</span>  };</div>
<div class="line"><a id="l01090" name="l01090"></a><span class="lineno"> 1090</span>  <span class="keywordflow">return</span> sync_connect_impl(err_code, &amp;async_connect_impl_func);</div>
<div class="line"><a id="l01091" name="l01091"></a><span class="lineno"> 1091</span> </div>
<div class="line"><a id="l01092" name="l01092"></a><span class="lineno"> 1092</span>  <span class="comment">/* Perf note: The above function-object-wrangling setup does not exactly scream blinding speed... but:</span></div>
<div class="line"><a id="l01093" name="l01093"></a><span class="lineno"> 1093</span><span class="comment">   *   - It is still non-blocking/synchronous.</span></div>
<div class="line"><a id="l01094" name="l01094"></a><span class="lineno"> 1094</span><span class="comment">   *   - Session connect is a rare operation.</span></div>
<div class="line"><a id="l01095" name="l01095"></a><span class="lineno"> 1095</span><span class="comment">   *   - Even disregarding the preceding bullet, the function-object-wrangling is probably minor compared to all</span></div>
<div class="line"><a id="l01096" name="l01096"></a><span class="lineno"> 1096</span><span class="comment">   *     the stuff async_connect() must do.</span></div>
<div class="line"><a id="l01097" name="l01097"></a><span class="lineno"> 1097</span><span class="comment">   * So the code reuse/relative brevity is worth it. */</span></div>
<div class="line"><a id="l01098" name="l01098"></a><span class="lineno"> 1098</span>}</div>
<div class="line"><a id="l01099" name="l01099"></a><span class="lineno"> 1099</span> </div>
<div class="line"><a id="l01100" name="l01100"></a><span class="lineno"> 1100</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01101" name="l01101"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a1a7560109fa2aa2c16d4f4159918e2c2"> 1101</a></span><span class="keywordtype">bool</span> CLASS_CLI_SESSION_IMPL::sync_connect_impl(<a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code,</div>
<div class="line"><a id="l01102" name="l01102"></a><span class="lineno"> 1102</span>                                               <a class="code hl_typedef" href="namespaceipc.html#aa455c7f045059736578ca275fc1a851f">Function</a>&lt;<span class="keywordtype">bool</span> (flow::async::Task_asio_err&amp;&amp;)&gt;* async_connect_impl_func)</div>
<div class="line"><a id="l01103" name="l01103"></a><span class="lineno"> 1103</span>{</div>
<div class="line"><a id="l01104" name="l01104"></a><span class="lineno"> 1104</span>  <span class="keyword">using </span>flow::async::Task_asio_err;</div>
<div class="line"><a id="l01105" name="l01105"></a><span class="lineno"> 1105</span>  <span class="keyword">using </span>boost::promise;</div>
<div class="line"><a id="l01106" name="l01106"></a><span class="lineno"> 1106</span> </div>
<div class="line"><a id="l01107" name="l01107"></a><span class="lineno"> 1107</span>  FLOW_ERROR_EXEC_AND_THROW_ON_ERROR(<span class="keywordtype">bool</span>, sync_connect_impl, _1, async_connect_impl_func);</div>
<div class="line"><a id="l01108" name="l01108"></a><span class="lineno"> 1108</span>  <span class="comment">// ^-- Call ourselves and return if err_code is null.  If got to present line, err_code is not null.</span></div>
<div class="line"><a id="l01109" name="l01109"></a><span class="lineno"> 1109</span> </div>
<div class="line"><a id="l01110" name="l01110"></a><span class="lineno"> 1110</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l01111" name="l01111"></a><span class="lineno"> 1111</span> </div>
<div class="line"><a id="l01112" name="l01112"></a><span class="lineno"> 1112</span>  <span class="comment">// Unless it returns false right away, this completion handler shall execute.</span></div>
<div class="line"><a id="l01113" name="l01113"></a><span class="lineno"> 1113</span>  promise&lt;void&gt; done_promise;</div>
<div class="line"><a id="l01114" name="l01114"></a><span class="lineno"> 1114</span>  <span class="keyword">auto</span> on_done_func = [&amp;](<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; async_err_code)</div>
<div class="line"><a id="l01115" name="l01115"></a><span class="lineno"> 1115</span>  {</div>
<div class="line"><a id="l01116" name="l01116"></a><span class="lineno"> 1116</span>    <span class="comment">// We are in thread W (non-blockingly-soon after async_connect() started).</span></div>
<div class="line"><a id="l01117" name="l01117"></a><span class="lineno"> 1117</span>    *err_code = async_err_code;</div>
<div class="line"><a id="l01118" name="l01118"></a><span class="lineno"> 1118</span>    done_promise.set_value();</div>
<div class="line"><a id="l01119" name="l01119"></a><span class="lineno"> 1119</span>  };</div>
<div class="line"><a id="l01120" name="l01120"></a><span class="lineno"> 1120</span> </div>
<div class="line"><a id="l01121" name="l01121"></a><span class="lineno"> 1121</span>  <span class="comment">/* In something closer to English: this is: async_connect(..., on_done_func), where ... are the args -- except</span></div>
<div class="line"><a id="l01122" name="l01122"></a><span class="lineno"> 1122</span><span class="comment">   * err_code -- passed to calling sync_connect() by user.  Just we&#39;re allowing a guy like us, but not necessarily us</span></div>
<div class="line"><a id="l01123" name="l01123"></a><span class="lineno"> 1123</span><span class="comment">   * (for example shm::classic::Client_session_impl), to reuse our little promise-wait technique above. */</span></div>
<div class="line"><a id="l01124" name="l01124"></a><span class="lineno"> 1124</span>  <span class="keywordflow">if</span> (!(*async_connect_impl_func)(Task_asio_err(std::move(on_done_func))))</div>
<div class="line"><a id="l01125" name="l01125"></a><span class="lineno"> 1125</span>  {</div>
<div class="line"><a id="l01126" name="l01126"></a><span class="lineno"> 1126</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01127" name="l01127"></a><span class="lineno"> 1127</span>  }</div>
<div class="line"><a id="l01128" name="l01128"></a><span class="lineno"> 1128</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01129" name="l01129"></a><span class="lineno"> 1129</span> </div>
<div class="line"><a id="l01130" name="l01130"></a><span class="lineno"> 1130</span>  done_promise.get_future().wait(); <span class="comment">// Non-blocking amount of waiting.</span></div>
<div class="line"><a id="l01131" name="l01131"></a><span class="lineno"> 1131</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l01132" name="l01132"></a><span class="lineno"> 1132</span>} <span class="comment">// Client_session_impl::sync_connect_impl()</span></div>
<div class="line"><a id="l01133" name="l01133"></a><span class="lineno"> 1133</span> </div>
<div class="line"><a id="l01134" name="l01134"></a><span class="lineno"> 1134</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01135" name="l01135"></a><span class="lineno"> 1135</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l01136" name="l01136"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a56c0d2b0ff082d1f7b0738e2528b4a92"> 1136</a></span><span class="keywordtype">bool</span> CLASS_CLI_SESSION_IMPL::async_connect(<span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a9d93e6080abf3b0827b97e084f5e8356">Mdt_builder_ptr</a>&amp; mdt,</div>
<div class="line"><a id="l01137" name="l01137"></a><span class="lineno"> 1137</span>                                           <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a>* init_channels_by_cli_req_pre_sized,</div>
<div class="line"><a id="l01138" name="l01138"></a><span class="lineno"> 1138</span>                                           <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a>* mdt_from_srv_or_null,</div>
<div class="line"><a id="l01139" name="l01139"></a><span class="lineno"> 1139</span>                                           <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a>* init_channels_by_srv_req,</div>
<div class="line"><a id="l01140" name="l01140"></a><span class="lineno"> 1140</span>                                           Task_err&amp;&amp; on_done_func)</div>
<div class="line"><a id="l01141" name="l01141"></a><span class="lineno"> 1141</span>{</div>
<div class="line"><a id="l01142" name="l01142"></a><span class="lineno"> 1142</span>  <span class="keyword">using </span><a class="code hl_typedef" href="namespaceipc_1_1util.html#a0c44028a45451ebf21f6af8e806b2682">util::process_id_t</a>;</div>
<div class="line"><a id="l01143" name="l01143"></a><span class="lineno"> 1143</span>  <span class="keyword">using </span>flow::util::ostream_op_string;</div>
<div class="line"><a id="l01144" name="l01144"></a><span class="lineno"> 1144</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l01145" name="l01145"></a><span class="lineno"> 1145</span>  <span class="keyword">using </span>Named_sh_mutex = boost::interprocess::named_mutex;</div>
<div class="line"><a id="l01146" name="l01146"></a><span class="lineno"> 1146</span>  <span class="keyword">using </span>Named_sh_mutex_ptr = boost::movelib::unique_ptr&lt;Named_sh_mutex&gt;;</div>
<div class="line"><a id="l01147" name="l01147"></a><span class="lineno"> 1147</span>  <span class="keyword">using </span>Sh_lock_guard = boost::interprocess::scoped_lock&lt;Named_sh_mutex&gt;;</div>
<div class="line"><a id="l01148" name="l01148"></a><span class="lineno"> 1148</span>  <span class="keyword">using </span>boost::system::system_category;</div>
<div class="line"><a id="l01149" name="l01149"></a><span class="lineno"> 1149</span>  <span class="keyword">using </span>boost::lexical_cast;</div>
<div class="line"><a id="l01150" name="l01150"></a><span class="lineno"> 1150</span>  <span class="keyword">using </span>boost::bad_lexical_cast;</div>
<div class="line"><a id="l01151" name="l01151"></a><span class="lineno"> 1151</span>  <span class="keyword">using </span>boost::movelib::make_unique;</div>
<div class="line"><a id="l01152" name="l01152"></a><span class="lineno"> 1152</span>  <span class="keyword">using </span>boost::make_shared;</div>
<div class="line"><a id="l01153" name="l01153"></a><span class="lineno"> 1153</span>  <span class="keyword">using </span>boost::io::ios_all_saver;</div>
<div class="line"><a id="l01154" name="l01154"></a><span class="lineno"> 1154</span>  <span class="keyword">using </span>fs::ifstream;</div>
<div class="line"><a id="l01155" name="l01155"></a><span class="lineno"> 1155</span>  <span class="keyword">using </span>std::getline;</div>
<div class="line"><a id="l01156" name="l01156"></a><span class="lineno"> 1156</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l01157" name="l01157"></a><span class="lineno"> 1157</span>  <span class="keyword">using </span>std::to_string;</div>
<div class="line"><a id="l01158" name="l01158"></a><span class="lineno"> 1158</span>  <span class="comment">// using ::errno; // It&#39;s a macro apparently.</span></div>
<div class="line"><a id="l01159" name="l01159"></a><span class="lineno"> 1159</span> </div>
<div class="line"><a id="l01160" name="l01160"></a><span class="lineno"> 1160</span>  <span class="comment">/* Maintenance note:</span></div>
<div class="line"><a id="l01161" name="l01161"></a><span class="lineno"> 1161</span><span class="comment">   * Please see &quot;CONNECTING state and asynchronicity&quot; in class doc header for key background.</span></div>
<div class="line"><a id="l01162" name="l01162"></a><span class="lineno"> 1162</span><span class="comment">   * Then come back here.  Especially heed this is trying to network-enable this code. */</span></div>
<div class="line"><a id="l01163" name="l01163"></a><span class="lineno"> 1163</span> </div>
<div class="line"><a id="l01164" name="l01164"></a><span class="lineno"> 1164</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l01165" name="l01165"></a><span class="lineno"> 1165</span>  assert((!m_async_worker.in_thread()) &amp;&amp; <span class="stringliteral">&quot;Do not call directly from its own completion handler.&quot;</span>);</div>
<div class="line"><a id="l01166" name="l01166"></a><span class="lineno"> 1166</span> </div>
<div class="line"><a id="l01167" name="l01167"></a><span class="lineno"> 1167</span>  assert(<span class="keyword">reinterpret_cast&lt;</span><a class="code hl_struct" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html">Master_channel_req</a>*<span class="keyword">&gt;</span>(mdt.get())-&gt;<a class="code hl_variable" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html#a8cab22f0afe897330ad77a2bc2b536b7">m_req_msg</a>.body_root()-&gt;isLogInReq()</div>
<div class="line"><a id="l01168" name="l01168"></a><span class="lineno"> 1168</span>         &amp;&amp; <span class="stringliteral">&quot;Did you pass PEER-state-mdt_builder() result to async_connect()?  Use NULL-state one instead.  &quot;</span></div>
<div class="line"><a id="l01169" name="l01169"></a><span class="lineno"> 1169</span>            <span class="stringliteral">&quot;Where did you even get it -- another Client_session?  Bad boy.&quot;</span>);</div>
<div class="line"><a id="l01170" name="l01170"></a><span class="lineno"> 1170</span> </div>
<div class="line"><a id="l01171" name="l01171"></a><span class="lineno"> 1171</span>  <span class="keyword">const</span> <span class="keyword">auto</span> do_func = [&amp;]() -&gt; <span class="keywordtype">bool</span> <span class="comment">// Little helper that lets us concisely use `return &lt;bool&gt;;`.</span></div>
<div class="line"><a id="l01172" name="l01172"></a><span class="lineno"> 1172</span>  {</div>
<div class="line"><a id="l01173" name="l01173"></a><span class="lineno"> 1173</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01174" name="l01174"></a><span class="lineno"> 1174</span> </div>
<div class="line"><a id="l01175" name="l01175"></a><span class="lineno"> 1175</span>    <span class="keywordflow">if</span> (m_state != State::S_NULL)</div>
<div class="line"><a id="l01176" name="l01176"></a><span class="lineno"> 1176</span>    {</div>
<div class="line"><a id="l01177" name="l01177"></a><span class="lineno"> 1177</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Wanted to start &quot;</span></div>
<div class="line"><a id="l01178" name="l01178"></a><span class="lineno"> 1178</span>                       <span class="stringliteral">&quot;but already not in NULL state.  Ignoring.&quot;</span>);</div>
<div class="line"><a id="l01179" name="l01179"></a><span class="lineno"> 1179</span>      <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01180" name="l01180"></a><span class="lineno"> 1180</span>    }</div>
<div class="line"><a id="l01181" name="l01181"></a><span class="lineno"> 1181</span>    <span class="comment">// else we are going to CONNECTING state.</span></div>
<div class="line"><a id="l01182" name="l01182"></a><span class="lineno"> 1182</span> </div>
<div class="line"><a id="l01183" name="l01183"></a><span class="lineno"> 1183</span>    m_state = State::S_CONNECTING;</div>
<div class="line"><a id="l01184" name="l01184"></a><span class="lineno"> 1184</span>    <span class="comment">/* Maintenance note: If/when some form of *this becomes network-enabled (async_connect() becomes public),</span></div>
<div class="line"><a id="l01185" name="l01185"></a><span class="lineno"> 1185</span><span class="comment">     * the following statement will become true: m_conn_on_done_func_or_empty() may now beinvoked from thread W or</span></div>
<div class="line"><a id="l01186" name="l01186"></a><span class="lineno"> 1186</span><span class="comment">     * thread U (dtor) (a race).  Hence dtor code will need to be added to indeed invoke it with operation-aborted</span></div>
<div class="line"><a id="l01187" name="l01187"></a><span class="lineno"> 1187</span><span class="comment">     * code, if it is still not .empty() by then.  That&#39;s why -- to make networking-enabling `*this` easier --</span></div>
<div class="line"><a id="l01188" name="l01188"></a><span class="lineno"> 1188</span><span class="comment">     * we even save m_conn_on_done_func_or_empty as opposed to only passing it around in lambda capture(s). */</span></div>
<div class="line"><a id="l01189" name="l01189"></a><span class="lineno"> 1189</span>    m_conn_on_done_func_or_empty = std::move(on_done_func);</div>
<div class="line"><a id="l01190" name="l01190"></a><span class="lineno"> 1190</span> </div>
<div class="line"><a id="l01191" name="l01191"></a><span class="lineno"> 1191</span>    <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code;</div>
<div class="line"><a id="l01192" name="l01192"></a><span class="lineno"> 1192</span> </div>
<div class="line"><a id="l01193" name="l01193"></a><span class="lineno"> 1193</span>    <span class="comment">/* Let&#39;s overview our task as the session-opening client.  We are a client, so we open sessions.  In fact</span></div>
<div class="line"><a id="l01194" name="l01194"></a><span class="lineno"> 1194</span><span class="comment">     * *this is expressly for opening 1 (one) session: if they want to open another one, they&#39;d make another</span></div>
<div class="line"><a id="l01195" name="l01195"></a><span class="lineno"> 1195</span><span class="comment">     * Client_session (and moreover it would be an abuse of the concept to do so, to the same Server_app, while</span></div>
<div class="line"><a id="l01196" name="l01196"></a><span class="lineno"> 1196</span><span class="comment">     * *this exists, but I digress, and we don&#39;t care about that).  How to open a session?  That&#39;s isomorphic to</span></div>
<div class="line"><a id="l01197" name="l01197"></a><span class="lineno"> 1197</span><span class="comment">     * opening a *session master channel* (see session_master_channel.capnp now).  Because it is the channel used</span></div>
<div class="line"><a id="l01198" name="l01198"></a><span class="lineno"> 1198</span><span class="comment">     * for opening user channels, it must be able to transmit native handles (see Native_socket_stream doc header,</span></div>
<div class="line"><a id="l01199" name="l01199"></a><span class="lineno"> 1199</span><span class="comment">     * regaring &quot;way 1&quot; and &quot;way 2&quot; of establishing an N_s_s connection; we&#39;re establishing here the thing that</span></div>
<div class="line"><a id="l01200" name="l01200"></a><span class="lineno"> 1200</span><span class="comment">     * will allow the preferred &quot;way 2&quot; to happen subsequently).  So this channel will require at least a</span></div>
<div class="line"><a id="l01201" name="l01201"></a><span class="lineno"> 1201</span><span class="comment">     * Native_socket_stream (handles) pipe.  Would it benefit from MQ pipes?  Probably not; we fully control the</span></div>
<div class="line"><a id="l01202" name="l01202"></a><span class="lineno"> 1202</span><span class="comment">     * schema (no user schema involved yet), and it&#39;s fairly small messages only.  So just a single-duplex-handles-pipe</span></div>
<div class="line"><a id="l01203" name="l01203"></a><span class="lineno"> 1203</span><span class="comment">     * channel is fine.  Therefore, all we need to establish before we can load up our Channel&lt;&gt; peer object is</span></div>
<div class="line"><a id="l01204" name="l01204"></a><span class="lineno"> 1204</span><span class="comment">     * a Native_socket_stream peer object in PEER (connected) state.  As mentioned before, there&#39;s way 1 and way 2</span></div>
<div class="line"><a id="l01205" name="l01205"></a><span class="lineno"> 1205</span><span class="comment">     * theoretically available; but (as noted) way 2 requires an existing channel for native-handle transmission</span></div>
<div class="line"><a id="l01206" name="l01206"></a><span class="lineno"> 1206</span><span class="comment">     * (chicken/egg), and we lack that.  Hence way 1 is the only one available at the moment.</span></div>
<div class="line"><a id="l01207" name="l01207"></a><span class="lineno"> 1207</span><span class="comment">     *</span></div>
<div class="line"><a id="l01208" name="l01208"></a><span class="lineno"> 1208</span><span class="comment">     * So far, so good; way 1 involves an N_s_s_acceptor listening and doing async_accept()s and an</span></div>
<div class="line"><a id="l01209" name="l01209"></a><span class="lineno"> 1209</span><span class="comment">     * N_s_s cted in NULL state performing a sync_connect().  We&#39;re the client, so we&#39;ll be doing the latter.</span></div>
<div class="line"><a id="l01210" name="l01210"></a><span class="lineno"> 1210</span><span class="comment">     * Way 1, sadly, means we&#39;ll need a name to which to connect.  As discussed elsewhere, all shared resources</span></div>
<div class="line"><a id="l01211" name="l01211"></a><span class="lineno"> 1211</span><span class="comment">     * that are per-session are first segregated by Server_app::m_name (&lt;=&gt; distinct server application); then by</span></div>
<div class="line"><a id="l01212" name="l01212"></a><span class="lineno"> 1212</span><span class="comment">     * *server namespace* within that (&lt;=&gt; distinct server application *instance* a/k/a process &lt;=&gt; PID); and</span></div>
<div class="line"><a id="l01213" name="l01213"></a><span class="lineno"> 1213</span><span class="comment">     * then by session.  Since we&#39;re creating the session now, we need the levels of naming above that.</span></div>
<div class="line"><a id="l01214" name="l01214"></a><span class="lineno"> 1214</span><span class="comment">     * We know the Server_app (&lt;=&gt; Server_app::m_name); so we needed the server namespace.  This is stored in</span></div>
<div class="line"><a id="l01215" name="l01215"></a><span class="lineno"> 1215</span><span class="comment">     * the CNS (Current Namespace Store) which is a formal name for the damned PID file (&lt;=&gt; process instance).</span></div>
<div class="line"><a id="l01216" name="l01216"></a><span class="lineno"> 1216</span><span class="comment">     * So read the PID file to get the name.  (Access to this must be synchronized against being written; details</span></div>
<div class="line"><a id="l01217" name="l01217"></a><span class="lineno"> 1217</span><span class="comment">     * below in that step.)</span></div>
<div class="line"><a id="l01218" name="l01218"></a><span class="lineno"> 1218</span><span class="comment">     *</span></div>
<div class="line"><a id="l01219" name="l01219"></a><span class="lineno"> 1219</span><span class="comment">     * Then we&#39;ll just sync-connect to the name built off that PID (and the other stuff including Server_app::m_name).</span></div>
<div class="line"><a id="l01220" name="l01220"></a><span class="lineno"> 1220</span><span class="comment">     * As a result we&#39;ll have our Native_socket_stream peer object in PEER state.  It is then trivial to wrap it</span></div>
<div class="line"><a id="l01221" name="l01221"></a><span class="lineno"> 1221</span><span class="comment">     * in a one-pipe Channel&lt;&gt;.</span></div>
<div class="line"><a id="l01222" name="l01222"></a><span class="lineno"> 1222</span><span class="comment">     *</span></div>
<div class="line"><a id="l01223" name="l01223"></a><span class="lineno"> 1223</span><span class="comment">     * The session master channel is a structured channel (struc::Channel&lt;&gt; peer object, wrapping the Channel&lt;&gt;,</span></div>
<div class="line"><a id="l01224" name="l01224"></a><span class="lineno"> 1224</span><span class="comment">     * is therefore what we want next).  That&#39;s again simple.</span></div>
<div class="line"><a id="l01225" name="l01225"></a><span class="lineno"> 1225</span><span class="comment">     *</span></div>
<div class="line"><a id="l01226" name="l01226"></a><span class="lineno"> 1226</span><span class="comment">     * However, being the session master channel specifically, it has a log-in phase (otherwise optional: and in fact</span></div>
<div class="line"><a id="l01227" name="l01227"></a><span class="lineno"> 1227</span><span class="comment">     * this type of channel is the only one that has one).  So we&#39;ll need to perform a quick exchange at the</span></div>
<div class="line"><a id="l01228" name="l01228"></a><span class="lineno"> 1228</span><span class="comment">     * start of the struc::Channel&lt;&gt;&#39;s lifetime.  If that&#39;s successful, we are done. */</span></div>
<div class="line"><a id="l01229" name="l01229"></a><span class="lineno"> 1229</span> </div>
<div class="line"><a id="l01230" name="l01230"></a><span class="lineno"> 1230</span>    <span class="comment">// So first step is to read the CNS (Current Namespace Store): the PID file.</span></div>
<div class="line"><a id="l01231" name="l01231"></a><span class="lineno"> 1231</span> </div>
<div class="line"><a id="l01232" name="l01232"></a><span class="lineno"> 1232</span>    <span class="comment">/* PID file can be written-to by the server (that&#39;s the whole point), so no choice but to use locking.</span></div>
<div class="line"><a id="l01233" name="l01233"></a><span class="lineno"> 1233</span><span class="comment">     * Various techniques exist, including using the file itself as a lock, but we shall be using a bipc named mutex</span></div>
<div class="line"><a id="l01234" name="l01234"></a><span class="lineno"> 1234</span><span class="comment">     * (can be thought of as a tiny SHM pool storing just the single mutex -- semaphore in Linux).</span></div>
<div class="line"><a id="l01235" name="l01235"></a><span class="lineno"> 1235</span><span class="comment">     * Because it&#39;s so small and unique (per app), we won&#39;t worry about corruption and cleanup.</span></div>
<div class="line"><a id="l01236" name="l01236"></a><span class="lineno"> 1236</span><span class="comment">     * (@todo Reconsider that.)  Why the separate mutex, instead of using file as a lock?  Answer: in the</span></div>
<div class="line"><a id="l01237" name="l01237"></a><span class="lineno"> 1237</span><span class="comment">     * 1st place, it&#39;s arguably easier to use anyway -- the bipc file-lock mechanism is slick but shows the</span></div>
<div class="line"><a id="l01238" name="l01238"></a><span class="lineno"> 1238</span><span class="comment">     * slight oddness of the technique.  Also, for future development: we may need to store other information, such</span></div>
<div class="line"><a id="l01239" name="l01239"></a><span class="lineno"> 1239</span><span class="comment">     * as info on kernel-persistent objects to clean in the even of a crash/abort, in a separate file but</span></div>
<div class="line"><a id="l01240" name="l01240"></a><span class="lineno"> 1240</span><span class="comment">     * accessed in the same critical section as the CNS (PID file).  Hence a common lock would be required for</span></div>
<div class="line"><a id="l01241" name="l01241"></a><span class="lineno"> 1241</span><span class="comment">     * both CNS and these other resources; then it would be odd to use file A as a lock for files A, B, C....</span></div>
<div class="line"><a id="l01242" name="l01242"></a><span class="lineno"> 1242</span><span class="comment">     *</span></div>
<div class="line"><a id="l01243" name="l01243"></a><span class="lineno"> 1243</span><span class="comment">     * One subtlety *is* added due to the decision to use it: ownership and permissions on the mutex.</span></div>
<div class="line"><a id="l01244" name="l01244"></a><span class="lineno"> 1244</span><span class="comment">     * This is discussed in detail in Session_server_impl, where it similarly locks this mutex.</span></div>
<div class="line"><a id="l01245" name="l01245"></a><span class="lineno"> 1245</span><span class="comment">     * The bottom line is we may need to be the ones to create it, hence OPEN_OR_CREATE; and therefore</span></div>
<div class="line"><a id="l01246" name="l01246"></a><span class="lineno"> 1246</span><span class="comment">     * we need to specify permissions; and the permissions value is based on Server_app [sic] despite our being</span></div>
<div class="line"><a id="l01247" name="l01247"></a><span class="lineno"> 1247</span><span class="comment">     * the client.  This is explained in the aforementioned spot in Session_server_impl. */</span></div>
<div class="line"><a id="l01248" name="l01248"></a><span class="lineno"> 1248</span> </div>
<div class="line"><a id="l01249" name="l01249"></a><span class="lineno"> 1249</span>    <span class="keywordtype">string</span> srv_namespace_mv;</div>
<div class="line"><a id="l01250" name="l01250"></a><span class="lineno"> 1250</span>    <span class="keyword">const</span> <span class="keyword">auto</span> mutex_name = Base::cur_ns_store_mutex_absolute_name();</div>
<div class="line"><a id="l01251" name="l01251"></a><span class="lineno"> 1251</span>    <span class="keyword">const</span> <span class="keyword">auto</span> mutex_perms = <a class="code hl_function" href="namespaceipc_1_1util.html#abda2ce5bcdbc26ca63d667b87818439c">util::shared_resource_permissions</a>(Base::m_srv_app_ref.m_permissions_level_for_client_apps);</div>
<div class="line"><a id="l01252" name="l01252"></a><span class="lineno"> 1252</span>    <span class="keyword">const</span> <span class="keyword">auto</span> cns_path = Base::cur_ns_store_absolute_path();</div>
<div class="line"><a id="l01253" name="l01253"></a><span class="lineno"> 1253</span>    {</div>
<div class="line"><a id="l01254" name="l01254"></a><span class="lineno"> 1254</span>      ios_all_saver saver(*(get_logger()-&gt;this_thread_ostream())); <span class="comment">// Revert std::oct/etc. soon.</span></div>
<div class="line"><a id="l01255" name="l01255"></a><span class="lineno"> 1255</span>      FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Starting session-connector thread &quot;</span></div>
<div class="line"><a id="l01256" name="l01256"></a><span class="lineno"> 1256</span>                    <span class="stringliteral">&quot;and connecting.  Presumably the CNS (Current Namespace Store), a/k/a PID &quot;</span></div>
<div class="line"><a id="l01257" name="l01257"></a><span class="lineno"> 1257</span>                    <span class="stringliteral">&quot;file [&quot;</span> &lt;&lt; cns_path &lt;&lt; <span class="stringliteral">&quot;] (shared-mutex name [&quot;</span> &lt;&lt; mutex_name &lt;&lt; <span class="stringliteral">&quot;], shared-mutex perms &quot;</span></div>
<div class="line"><a id="l01258" name="l01258"></a><span class="lineno"> 1258</span>                    <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; std::setfill(<span class="charliteral">&#39;0&#39;</span>) &lt;&lt; std::setw(4) &lt;&lt; std::oct &lt;&lt; mutex_perms.get_permissions() &lt;&lt; <span class="stringliteral">&quot;]), &quot;</span></div>
<div class="line"><a id="l01259" name="l01259"></a><span class="lineno"> 1259</span>                    <span class="stringliteral">&quot;exists.&quot;</span>);</div>
<div class="line"><a id="l01260" name="l01260"></a><span class="lineno"> 1260</span>    }</div>
<div class="line"><a id="l01261" name="l01261"></a><span class="lineno"> 1261</span> </div>
<div class="line"><a id="l01262" name="l01262"></a><span class="lineno"> 1262</span>    Named_sh_mutex_ptr sh_mutex;</div>
<div class="line"><a id="l01263" name="l01263"></a><span class="lineno"> 1263</span>    <a class="code hl_function" href="namespaceipc_1_1util.html#abd43da87aa17031604c7906757c07d46">util::op_with_possible_bipc_exception</a>(get_logger(), &amp;err_code, <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa7300721595cc25baa9a9e43bd76296aa">error::Code::S_MUTEX_BIPC_MISC_LIBRARY_ERROR</a>,</div>
<div class="line"><a id="l01264" name="l01264"></a><span class="lineno"> 1264</span>                                          <span class="stringliteral">&quot;Client_session_impl::async_connect()&quot;</span>, [&amp;]()</div>
<div class="line"><a id="l01265" name="l01265"></a><span class="lineno"> 1265</span>    {</div>
<div class="line"><a id="l01266" name="l01266"></a><span class="lineno"> 1266</span>      sh_mutex = make_unique&lt;Named_sh_mutex&gt;(<a class="code hl_variable" href="namespaceipc_1_1util.html#a5664539b3d75d6d10cdfebf6eac5382d">util::OPEN_OR_CREATE</a>, mutex_name.native_str(), mutex_perms);</div>
<div class="line"><a id="l01267" name="l01267"></a><span class="lineno"> 1267</span>    });</div>
<div class="line"><a id="l01268" name="l01268"></a><span class="lineno"> 1268</span> </div>
<div class="line"><a id="l01269" name="l01269"></a><span class="lineno"> 1269</span>    <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01270" name="l01270"></a><span class="lineno"> 1270</span>    {</div>
<div class="line"><a id="l01271" name="l01271"></a><span class="lineno"> 1271</span>      Sh_lock_guard sh_lock(*sh_mutex);</div>
<div class="line"><a id="l01272" name="l01272"></a><span class="lineno"> 1272</span> </div>
<div class="line"><a id="l01273" name="l01273"></a><span class="lineno"> 1273</span>      ifstream cns_file(cns_path);</div>
<div class="line"><a id="l01274" name="l01274"></a><span class="lineno"> 1274</span>      <span class="keywordflow">if</span> (!cns_file.good()) <span class="comment">// #1</span></div>
<div class="line"><a id="l01275" name="l01275"></a><span class="lineno"> 1275</span>      {</div>
<div class="line"><a id="l01276" name="l01276"></a><span class="lineno"> 1276</span>        <span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> sys_err_code(errno, system_category());</div>
<div class="line"><a id="l01277" name="l01277"></a><span class="lineno"> 1277</span>        FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Could not read CNS (PID) file &quot;</span></div>
<div class="line"><a id="l01278" name="l01278"></a><span class="lineno"> 1278</span>                         <span class="stringliteral">&quot;file [&quot;</span> &lt;&lt; cns_path &lt;&lt; <span class="stringliteral">&quot;]; system error details follow.  Immediately giving &quot;</span></div>
<div class="line"><a id="l01279" name="l01279"></a><span class="lineno"> 1279</span>                         <span class="stringliteral">&quot;up (non-blocking).&quot;</span>);</div>
<div class="line"><a id="l01280" name="l01280"></a><span class="lineno"> 1280</span>        FLOW_ERROR_SYS_ERROR_LOG_WARNING(); <span class="comment">// Log based on sys_err_code.</span></div>
<div class="line"><a id="l01281" name="l01281"></a><span class="lineno"> 1281</span> </div>
<div class="line"><a id="l01282" name="l01282"></a><span class="lineno"> 1282</span>        err_code = sys_err_code;</div>
<div class="line"><a id="l01283" name="l01283"></a><span class="lineno"> 1283</span>      }</div>
<div class="line"><a id="l01284" name="l01284"></a><span class="lineno"> 1284</span>      <span class="keywordflow">else</span> <span class="comment">// if (cns_file.good()) // #1</span></div>
<div class="line"><a id="l01285" name="l01285"></a><span class="lineno"> 1285</span>      {</div>
<div class="line"><a id="l01286" name="l01286"></a><span class="lineno"> 1286</span>        assert(!err_code);</div>
<div class="line"><a id="l01287" name="l01287"></a><span class="lineno"> 1287</span> </div>
<div class="line"><a id="l01288" name="l01288"></a><span class="lineno"> 1288</span>        <span class="comment">/* Read up to a newline.  Be forgiving about whatever is after that; but the newline is required.</span></div>
<div class="line"><a id="l01289" name="l01289"></a><span class="lineno"> 1289</span><span class="comment">         * If it&#39;s not there, srv_namespace_mv will be fine (and either way won&#39;t include the newline), but .good() will</span></div>
<div class="line"><a id="l01290" name="l01290"></a><span class="lineno"> 1290</span><span class="comment">         * be false. */</span></div>
<div class="line"><a id="l01291" name="l01291"></a><span class="lineno"> 1291</span>        getline(cns_file, srv_namespace_mv);</div>
<div class="line"><a id="l01292" name="l01292"></a><span class="lineno"> 1292</span>        <span class="keywordflow">if</span> (!cns_file.good())</div>
<div class="line"><a id="l01293" name="l01293"></a><span class="lineno"> 1293</span>        {</div>
<div class="line"><a id="l01294" name="l01294"></a><span class="lineno"> 1294</span>          FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Opened CNS (PID) file &quot;</span></div>
<div class="line"><a id="l01295" name="l01295"></a><span class="lineno"> 1295</span>                           <span class="stringliteral">&quot;file [&quot;</span> &lt;&lt; cns_path &lt;&lt; <span class="stringliteral">&quot;]; but couldn&#39;t read a full newline-terminated line.  &quot;</span></div>
<div class="line"><a id="l01296" name="l01296"></a><span class="lineno"> 1296</span>                           <span class="stringliteral">&quot;Immediately giving up (non-blocking).&quot;</span>);</div>
<div class="line"><a id="l01297" name="l01297"></a><span class="lineno"> 1297</span>          err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa486f5607320d062fe89e559a1e7856b2">error::Code::S_CLIENT_NAMESPACE_STORE_BAD_FORMAT</a>;</div>
<div class="line"><a id="l01298" name="l01298"></a><span class="lineno"> 1298</span>        }</div>
<div class="line"><a id="l01299" name="l01299"></a><span class="lineno"> 1299</span>        <span class="comment">// else if (cns_file.good()): Fall through. // #2</span></div>
<div class="line"><a id="l01300" name="l01300"></a><span class="lineno"> 1300</span>      } <span class="comment">// else if (cns_file.good()) // #1</span></div>
<div class="line"><a id="l01301" name="l01301"></a><span class="lineno"> 1301</span>      <span class="comment">// In any case can close file now and unlock.</span></div>
<div class="line"><a id="l01302" name="l01302"></a><span class="lineno"> 1302</span>    } <span class="comment">// Sh_lock_guard sh_lock(*sh_mutex); // if (!err_code) (might have become truthy inside though)</span></div>
<div class="line"><a id="l01303" name="l01303"></a><span class="lineno"> 1303</span>    <span class="comment">// else if (err_code) { It logged fine already. }</span></div>
<div class="line"><a id="l01304" name="l01304"></a><span class="lineno"> 1304</span> </div>
<div class="line"><a id="l01305" name="l01305"></a><span class="lineno"> 1305</span>    <span class="comment">/* Might as well do this a bit early.  Or no-op if null.  By the way, it does not destroy the mutex itself,</span></div>
<div class="line"><a id="l01306" name="l01306"></a><span class="lineno"> 1306</span><span class="comment">     * just the handle to it.  Destroying it (via Named_sh_mutex::remove()) would be counter to the whole point of it.</span></div>
<div class="line"><a id="l01307" name="l01307"></a><span class="lineno"> 1307</span><span class="comment">     * This does, sort of, leak a bit of RAM but only a bit. */</span></div>
<div class="line"><a id="l01308" name="l01308"></a><span class="lineno"> 1308</span>    sh_mutex.reset();</div>
<div class="line"><a id="l01309" name="l01309"></a><span class="lineno"> 1309</span> </div>
<div class="line"><a id="l01310" name="l01310"></a><span class="lineno"> 1310</span>    <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01311" name="l01311"></a><span class="lineno"> 1311</span>    {</div>
<div class="line"><a id="l01312" name="l01312"></a><span class="lineno"> 1312</span>      <span class="comment">// Still OK so far.  Parse all of srv_namespace_mv via lexical_cast&lt;&gt; (which uses `istream &gt;&gt; process_id_t`).</span></div>
<div class="line"><a id="l01313" name="l01313"></a><span class="lineno"> 1313</span>      <a class="code hl_typedef" href="namespaceipc_1_1util.html#a0c44028a45451ebf21f6af8e806b2682">process_id_t</a> pid = 0; <span class="comment">// Initialize to eliminate (false) warning from some compilers.</span></div>
<div class="line"><a id="l01314" name="l01314"></a><span class="lineno"> 1314</span>      <span class="keywordflow">try</span></div>
<div class="line"><a id="l01315" name="l01315"></a><span class="lineno"> 1315</span>      {</div>
<div class="line"><a id="l01316" name="l01316"></a><span class="lineno"> 1316</span>        pid = lexical_cast&lt;process_id_t&gt;(srv_namespace_mv);</div>
<div class="line"><a id="l01317" name="l01317"></a><span class="lineno"> 1317</span>      }</div>
<div class="line"><a id="l01318" name="l01318"></a><span class="lineno"> 1318</span>      <span class="keywordflow">catch</span> (<span class="keyword">const</span> bad_lexical_cast&amp; exc)</div>
<div class="line"><a id="l01319" name="l01319"></a><span class="lineno"> 1319</span>      {</div>
<div class="line"><a id="l01320" name="l01320"></a><span class="lineno"> 1320</span>        FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Opened CNS (PID) file &quot;</span></div>
<div class="line"><a id="l01321" name="l01321"></a><span class="lineno"> 1321</span>                         <span class="stringliteral">&quot;file [&quot;</span> &lt;&lt; cns_path &lt;&lt; <span class="stringliteral">&quot;]; read a full newline-terminated line; but could not parse &quot;</span></div>
<div class="line"><a id="l01322" name="l01322"></a><span class="lineno"> 1322</span>                         <span class="stringliteral">&quot;it cleanly to an integer PID.  Immediately giving up (non-blocking).  &quot;</span></div>
<div class="line"><a id="l01323" name="l01323"></a><span class="lineno"> 1323</span>                         <span class="stringliteral">&quot;Exception detail: [&quot;</span> &lt;&lt; exc.what() &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01324" name="l01324"></a><span class="lineno"> 1324</span>        err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa486f5607320d062fe89e559a1e7856b2">error::Code::S_CLIENT_NAMESPACE_STORE_BAD_FORMAT</a>;</div>
<div class="line"><a id="l01325" name="l01325"></a><span class="lineno"> 1325</span>      }</div>
<div class="line"><a id="l01326" name="l01326"></a><span class="lineno"> 1326</span> </div>
<div class="line"><a id="l01327" name="l01327"></a><span class="lineno"> 1327</span>      <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01328" name="l01328"></a><span class="lineno"> 1328</span>      {</div>
<div class="line"><a id="l01329" name="l01329"></a><span class="lineno"> 1329</span>        <span class="comment">// Might be paranoid but just in case some spaces or smth were in srv_namespace_mv: convert back to eliminate.</span></div>
<div class="line"><a id="l01330" name="l01330"></a><span class="lineno"> 1330</span>        srv_namespace_mv = to_string(pid);</div>
<div class="line"><a id="l01331" name="l01331"></a><span class="lineno"> 1331</span>        Base::set_srv_namespace(<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(std::move(srv_namespace_mv)));</div>
<div class="line"><a id="l01332" name="l01332"></a><span class="lineno"> 1332</span>        <span class="comment">// srv_namespace_mv is now hosed.</span></div>
<div class="line"><a id="l01333" name="l01333"></a><span class="lineno"> 1333</span>        <span class="keyword">const</span> <span class="keyword">auto</span> acc_name = Base::session_master_socket_stream_acceptor_absolute_name();</div>
<div class="line"><a id="l01334" name="l01334"></a><span class="lineno"> 1334</span> </div>
<div class="line"><a id="l01335" name="l01335"></a><span class="lineno"> 1335</span>        <span class="comment">// Pretty important value; INFO should be okay verbosity-wise.</span></div>
<div class="line"><a id="l01336" name="l01336"></a><span class="lineno"> 1336</span>        FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Opened CNS (PID) file &quot;</span></div>
<div class="line"><a id="l01337" name="l01337"></a><span class="lineno"> 1337</span>                      <span class="stringliteral">&quot;file [&quot;</span> &lt;&lt; cns_path &lt;&lt; <span class="stringliteral">&quot;]; obtained server-namespace [&quot;</span> &lt;&lt; Base::srv_namespace() &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01338" name="l01338"></a><span class="lineno"> 1338</span>                      <span class="stringliteral">&quot;Can now initiate Native_socket_stream async-connect based on this name which is &quot;</span></div>
<div class="line"><a id="l01339" name="l01339"></a><span class="lineno"> 1339</span>                      <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; acc_name &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01340" name="l01340"></a><span class="lineno"> 1340</span> </div>
<div class="line"><a id="l01341" name="l01341"></a><span class="lineno"> 1341</span>        <span class="comment">/* Create NULL (unconnected) Native_socket_stream peer object and try to get it to PEER (connected).</span></div>
<div class="line"><a id="l01342" name="l01342"></a><span class="lineno"> 1342</span><span class="comment">         * We&#39;ll want a sync_io::N_s_s as opposed to N_s_s below; but it does not matter: their APIs are identical</span></div>
<div class="line"><a id="l01343" name="l01343"></a><span class="lineno"> 1343</span><span class="comment">         * until PEER state is reached, and at that point we give it to Channel anyway. */</span></div>
<div class="line"><a id="l01344" name="l01344"></a><span class="lineno"> 1344</span>        <a class="code hl_class" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">transport::sync_io::Native_socket_stream</a> sock_stm(get_logger(),</div>
<div class="line"><a id="l01345" name="l01345"></a><span class="lineno"> 1345</span>                                                          ostream_op_string(*<span class="keyword">this</span>, <span class="stringliteral">&quot;-&gt;&quot;</span>, Base::srv_namespace().str()));</div>
<div class="line"><a id="l01346" name="l01346"></a><span class="lineno"> 1346</span>        <span class="comment">/* Maintenance note: As noted in &quot;CONNECTING state and asynchronicity&quot; in class doc header:</span></div>
<div class="line"><a id="l01347" name="l01347"></a><span class="lineno"> 1347</span><span class="comment">         * This will need to use a hypothetical sock_stm.async_connect() and become an async step, when/if we</span></div>
<div class="line"><a id="l01348" name="l01348"></a><span class="lineno"> 1348</span><span class="comment">         * network-enable *this in some form.  There *is* no public sock_stm.sync_connect() as of this writing,</span></div>
<div class="line"><a id="l01349" name="l01349"></a><span class="lineno"> 1349</span><span class="comment">         * so if we wanted to write it that form now, we couldn&#39;t.  (Whether we would is an orthogonal question but</span></div>
<div class="line"><a id="l01350" name="l01350"></a><span class="lineno"> 1350</span><span class="comment">         * moot.) */</span></div>
<div class="line"><a id="l01351" name="l01351"></a><span class="lineno"> 1351</span>        sock_stm.<a class="code hl_function" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html#a2e22d55369f5bd67a4e0d277b73f2823">sync_connect</a>(acc_name, &amp;err_code);</div>
<div class="line"><a id="l01352" name="l01352"></a><span class="lineno"> 1352</span> </div>
<div class="line"><a id="l01353" name="l01353"></a><span class="lineno"> 1353</span>        <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01354" name="l01354"></a><span class="lineno"> 1354</span>        {</div>
<div class="line"><a id="l01355" name="l01355"></a><span class="lineno"> 1355</span>          <span class="comment">/* Connect succeeded, but we may quickly encounter problems anyway; so err_code may be truthy after all</span></div>
<div class="line"><a id="l01356" name="l01356"></a><span class="lineno"> 1356</span><span class="comment">           * ultimately.  We have pretty much all we need for the Channel to go into m_master_channel though. */</span></div>
<div class="line"><a id="l01357" name="l01357"></a><span class="lineno"> 1357</span>          FLOW_LOG_INFO</div>
<div class="line"><a id="l01358" name="l01358"></a><span class="lineno"> 1358</span>            (<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Master channel Native_socket_stream &quot;</span></div>
<div class="line"><a id="l01359" name="l01359"></a><span class="lineno"> 1359</span>             <span class="stringliteral">&quot;sync-connect to [&quot;</span> &lt;&lt; acc_name &lt;&lt; <span class="stringliteral">&quot;] successfully yielded [&quot;</span> &lt;&lt; sock_stm &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01360" name="l01360"></a><span class="lineno"> 1360</span>             <span class="stringliteral">&quot;Wrapping in 1-pipe Channel; then wrapping that in a direct-heap-serializing struc::Channel; &quot;</span></div>
<div class="line"><a id="l01361" name="l01361"></a><span class="lineno"> 1361</span>             <span class="stringliteral">&quot;then issuing log-in request.&quot;</span>);</div>
<div class="line"><a id="l01362" name="l01362"></a><span class="lineno"> 1362</span> </div>
<div class="line"><a id="l01363" name="l01363"></a><span class="lineno"> 1363</span>          <span class="comment">/* Bit of ipc::transport nerdery here:</span></div>
<div class="line"><a id="l01364" name="l01364"></a><span class="lineno"> 1364</span><span class="comment">           *   - struc::Channel needs sync_io-pattern-peer-bearing Channel to upgrade-from;</span></div>
<div class="line"><a id="l01365" name="l01365"></a><span class="lineno"> 1365</span><span class="comment">           *   - specifically we&#39;ve chosen Socket_stream_channel as that Channel type;</span></div>
<div class="line"><a id="l01366" name="l01366"></a><span class="lineno"> 1366</span><span class="comment">           *   - whose ctor takes a move(sync_io::Native_socket_stream) (sync_io-pattern Native_socket_stream);</span></div>
<div class="line"><a id="l01367" name="l01367"></a><span class="lineno"> 1367</span><span class="comment">           *   - which is why we made a sync_io::Native_socket_stream (not Native_socket_stream) sock_stm above */</span></div>
<div class="line"><a id="l01368" name="l01368"></a><span class="lineno"> 1368</span> </div>
<div class="line"><a id="l01369" name="l01369"></a><span class="lineno"> 1369</span>          <a class="code hl_class" href="classipc_1_1transport_1_1Socket__stream__channel.html">transport::Socket_stream_channel&lt;true&gt;</a></div>
<div class="line"><a id="l01370" name="l01370"></a><span class="lineno"> 1370</span>            unstructured_master_channel(get_logger(), ostream_op_string(<span class="stringliteral">&quot;smc-&quot;</span>, *<span class="keyword">this</span>), std::move(sock_stm));</div>
<div class="line"><a id="l01371" name="l01371"></a><span class="lineno"> 1371</span>          {</div>
<div class="line"><a id="l01372" name="l01372"></a><span class="lineno"> 1372</span>            <span class="keyword">const</span> <span class="keyword">auto</span> opposing_proc_creds = unstructured_master_channel.<a class="code hl_function" href="classipc_1_1transport_1_1Socket__stream__channel.html#acad7936d9a7db817bc46ee4fe479d838">remote_peer_process_credentials</a>(&amp;err_code);</div>
<div class="line"><a id="l01373" name="l01373"></a><span class="lineno"> 1373</span>            assert((!err_code) &amp;&amp; <span class="stringliteral">&quot;It really should not fail that early.  If it does look into this code.&quot;</span>);</div>
<div class="line"><a id="l01374" name="l01374"></a><span class="lineno"> 1374</span>            FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Opposing process info: [&quot;</span> &lt;&lt; opposing_proc_creds &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01375" name="l01375"></a><span class="lineno"> 1375</span>          }</div>
<div class="line"><a id="l01376" name="l01376"></a><span class="lineno"> 1376</span> </div>
<div class="line"><a id="l01377" name="l01377"></a><span class="lineno"> 1377</span>          <span class="comment">// sock_stm is now hosed.  We have the Channel.</span></div>
<div class="line"><a id="l01378" name="l01378"></a><span class="lineno"> 1378</span> </div>
<div class="line"><a id="l01379" name="l01379"></a><span class="lineno"> 1379</span>          <span class="comment">/* Finally: eat the Channel; make it live inside m_master_channel.  This session master channel requires</span></div>
<div class="line"><a id="l01380" name="l01380"></a><span class="lineno"> 1380</span><span class="comment">           * a log-in phase (the only such channel in the session), so use that ctor. */</span></div>
<div class="line"><a id="l01381" name="l01381"></a><span class="lineno"> 1381</span>          assert(!m_master_channel);</div>
<div class="line"><a id="l01382" name="l01382"></a><span class="lineno"> 1382</span>          m_master_channel</div>
<div class="line"><a id="l01383" name="l01383"></a><span class="lineno"> 1383</span>            = make_shared&lt;Master_structured_channel&gt;(get_logger(), std::move(unstructured_master_channel),</div>
<div class="line"><a id="l01384" name="l01384"></a><span class="lineno"> 1384</span>                                                     <a class="code hl_variable" href="classipc_1_1transport_1_1struc_1_1Channel__base.html#ab0eb05b5fb52364c99868a8535aaf26e">transport::struc::Channel_base::S_SERIALIZE_VIA_HEAP</a>,</div>
<div class="line"><a id="l01385" name="l01385"></a><span class="lineno"> 1385</span>                                                     <span class="keyword">false</span>); <span class="comment">// We are the client, not the server.</span></div>
<div class="line"><a id="l01386" name="l01386"></a><span class="lineno"> 1386</span>          <span class="comment">// unstructured_master_channel is now hosed.</span></div>
<div class="line"><a id="l01387" name="l01387"></a><span class="lineno"> 1387</span> </div>
<div class="line"><a id="l01388" name="l01388"></a><span class="lineno"> 1388</span>          <span class="comment">/* Also enable liveness checking and keep-alive; the other side will do the same.</span></div>
<div class="line"><a id="l01389" name="l01389"></a><span class="lineno"> 1389</span><span class="comment">           * Read comment in Server_session_impl in similar spot; the same applies symmetrically here. */</span></div>
<div class="line"><a id="l01390" name="l01390"></a><span class="lineno"> 1390</span>          m_master_channel-&gt;owned_channel_mutable()-&gt;auto_ping();</div>
<div class="line"><a id="l01391" name="l01391"></a><span class="lineno"> 1391</span>          m_master_channel-&gt;owned_channel_mutable()-&gt;idle_timer_run();</div>
<div class="line"><a id="l01392" name="l01392"></a><span class="lineno"> 1392</span> </div>
<div class="line"><a id="l01393" name="l01393"></a><span class="lineno"> 1393</span>          m_master_channel-&gt;start([<span class="keyword">this</span>, master_channel_observer = <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a6a1cb9c344c312b4eff5c360d7114e2c">Master_structured_channel_observer</a>(m_master_channel)]</div>
<div class="line"><a id="l01394" name="l01394"></a><span class="lineno"> 1394</span>                                    (<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; channel_err_code) <span class="keyword">mutable</span></div>
<div class="line"><a id="l01395" name="l01395"></a><span class="lineno"> 1395</span>          {</div>
<div class="line"><a id="l01396" name="l01396"></a><span class="lineno"> 1396</span>            <span class="comment">// We are in thread Wc (unspecified, really struc::Channel async callback thread).</span></div>
<div class="line"><a id="l01397" name="l01397"></a><span class="lineno"> 1397</span>            m_async_worker.post([<span class="keyword">this</span>,</div>
<div class="line"><a id="l01398" name="l01398"></a><span class="lineno"> 1398</span>                                 master_channel_observer = std::move(master_channel_observer),</div>
<div class="line"><a id="l01399" name="l01399"></a><span class="lineno"> 1399</span>                                 channel_err_code]()</div>
<div class="line"><a id="l01400" name="l01400"></a><span class="lineno"> 1400</span>            {</div>
<div class="line"><a id="l01401" name="l01401"></a><span class="lineno"> 1401</span>              on_master_channel_error(master_channel_observer, channel_err_code);</div>
<div class="line"><a id="l01402" name="l01402"></a><span class="lineno"> 1402</span>            });</div>
<div class="line"><a id="l01403" name="l01403"></a><span class="lineno"> 1403</span>            <span class="comment">// @todo Add unexpected response handlers?  One firing would be a bug, so formally shouldn&#39;t be needed....</span></div>
<div class="line"><a id="l01404" name="l01404"></a><span class="lineno"> 1404</span>          });</div>
<div class="line"><a id="l01405" name="l01405"></a><span class="lineno"> 1405</span> </div>
<div class="line"><a id="l01406" name="l01406"></a><span class="lineno"> 1406</span>          <span class="comment">/* OK!  m_master_channel is rocking... but in the log-in phase (as client).  Follow the quite-rigid steps</span></div>
<div class="line"><a id="l01407" name="l01407"></a><span class="lineno"> 1407</span><span class="comment">           * documented for that phase namely: create (and sync-nb-send) the log-in message and expect log-in</span></div>
<div class="line"><a id="l01408" name="l01408"></a><span class="lineno"> 1408</span><span class="comment">           * response in-message the receipt of which means logged-in phase has been reached.  So this is another</span></div>
<div class="line"><a id="l01409" name="l01409"></a><span class="lineno"> 1409</span><span class="comment">           * async step (we must await the response).  It should be quite quick, as the server is doing its half of</span></div>
<div class="line"><a id="l01410" name="l01410"></a><span class="lineno"> 1410</span><span class="comment">           * the algorithm right now, but I digress.</span></div>
<div class="line"><a id="l01411" name="l01411"></a><span class="lineno"> 1411</span><span class="comment">           *</span></div>
<div class="line"><a id="l01412" name="l01412"></a><span class="lineno"> 1412</span><span class="comment">           * Except, actually, the log-in request message has already been created in mdt_builder(), so as to give</span></div>
<div class="line"><a id="l01413" name="l01413"></a><span class="lineno"> 1413</span><span class="comment">           * user Builder into the metadata sub-field in there.  That should be mutated, as needed, and now</span></div>
<div class="line"><a id="l01414" name="l01414"></a><span class="lineno"> 1414</span><span class="comment">           * we fill out the rest of it and sync-nb-send it. */</span></div>
<div class="line"><a id="l01415" name="l01415"></a><span class="lineno"> 1415</span>          <span class="keyword">auto</span>&amp; log_in_req_msg = (<span class="keyword">reinterpret_cast&lt;</span><a class="code hl_struct" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html">Master_channel_req</a>*<span class="keyword">&gt;</span>(mdt.get()))-&gt;m_req_msg;</div>
<div class="line"><a id="l01416" name="l01416"></a><span class="lineno"> 1416</span> </div>
<div class="line"><a id="l01417" name="l01417"></a><span class="lineno"> 1417</span>          <span class="comment">// Fill out the log-in request.  See SessionMasterChannelMessageBody.LogInReq.</span></div>
<div class="line"><a id="l01418" name="l01418"></a><span class="lineno"> 1418</span>          <span class="keyword">auto</span> msg_root = log_in_req_msg.body_root()-&gt;getLogInReq();</div>
<div class="line"><a id="l01419" name="l01419"></a><span class="lineno"> 1419</span> </div>
<div class="line"><a id="l01420" name="l01420"></a><span class="lineno"> 1420</span>          <span class="comment">// Please see &quot;Protocol negotiation&quot; in our class doc header for discussion.</span></div>
<div class="line"><a id="l01421" name="l01421"></a><span class="lineno"> 1421</span>          m_protocol_negotiator.reset(); <span class="comment">// In case this is a 2nd, 3rd, ... connect attempt or something.</span></div>
<div class="line"><a id="l01422" name="l01422"></a><span class="lineno"> 1422</span>          m_protocol_negotiator_aux.reset();</div>
<div class="line"><a id="l01423" name="l01423"></a><span class="lineno"> 1423</span>          <span class="keyword">auto</span> proto_neg_root = msg_root.initProtocolNegotiationToServer();</div>
<div class="line"><a id="l01424" name="l01424"></a><span class="lineno"> 1424</span>          proto_neg_root.setMaxProtoVer(m_protocol_negotiator.local_max_proto_ver_for_sending());</div>
<div class="line"><a id="l01425" name="l01425"></a><span class="lineno"> 1425</span>          proto_neg_root.setMaxProtoVerAux(m_protocol_negotiator_aux.local_max_proto_ver_for_sending());</div>
<div class="line"><a id="l01426" name="l01426"></a><span class="lineno"> 1426</span>          <span class="comment">/* That was our advertising our capabilities to them.  We&#39;ll perform negotiation check at LogInRsp receipt.</span></div>
<div class="line"><a id="l01427" name="l01427"></a><span class="lineno"> 1427</span><span class="comment">           *</span></div>
<div class="line"><a id="l01428" name="l01428"></a><span class="lineno"> 1428</span><span class="comment">           * Maintenance note: This is also remarked upon as of this writing in the schema .capnp file around LogInReq:</span></div>
<div class="line"><a id="l01429" name="l01429"></a><span class="lineno"> 1429</span><span class="comment">           * If we add more versions than 1 in the future, *and* we aim to be backwards-compatible with at least 1</span></div>
<div class="line"><a id="l01430" name="l01430"></a><span class="lineno"> 1430</span><span class="comment">           * older protocol version, then we must be careful in the below LogInReq setter code; as at *this* time we</span></div>
<div class="line"><a id="l01431" name="l01431"></a><span class="lineno"> 1431</span><span class="comment">           * don&#39;t yet know server side&#39;s capabilities (not until LogInRsp!), hence we can&#39;t know which version to</span></div>
<div class="line"><a id="l01432" name="l01432"></a><span class="lineno"> 1432</span><span class="comment">           * speak.  So until then (which isn&#39;t long) we need to be protocol-version-agnostic. */</span></div>
<div class="line"><a id="l01433" name="l01433"></a><span class="lineno"> 1433</span> </div>
<div class="line"><a id="l01434" name="l01434"></a><span class="lineno"> 1434</span>          msg_root.setMqTypeOrNone(S_MQ_TYPE_OR_NONE);</div>
<div class="line"><a id="l01435" name="l01435"></a><span class="lineno"> 1435</span>          msg_root.setNativeHandleTransmissionEnabled(S_TRANSMIT_NATIVE_HANDLES);</div>
<div class="line"><a id="l01436" name="l01436"></a><span class="lineno"> 1436</span>          msg_root.setShmTypeOrNone(S_SHM_TYPE);</div>
<div class="line"><a id="l01437" name="l01437"></a><span class="lineno"> 1437</span>          <span class="comment">// .metadata is already filled out.</span></div>
<div class="line"><a id="l01438" name="l01438"></a><span class="lineno"> 1438</span>          msg_root.setNumInitChannelsByCliReq(init_channels_by_cli_req_pre_sized</div>
<div class="line"><a id="l01439" name="l01439"></a><span class="lineno"> 1439</span>                                                ? init_channels_by_cli_req_pre_sized-&gt;size()</div>
<div class="line"><a id="l01440" name="l01440"></a><span class="lineno"> 1440</span>                                                : 0);</div>
<div class="line"><a id="l01441" name="l01441"></a><span class="lineno"> 1441</span> </div>
<div class="line"><a id="l01442" name="l01442"></a><span class="lineno"> 1442</span>          <span class="keyword">auto</span> claimed_own_proc_creds = msg_root.initClaimedOwnProcessCredentials();</div>
<div class="line"><a id="l01443" name="l01443"></a><span class="lineno"> 1443</span>          claimed_own_proc_creds.setProcessId(<a class="code hl_function" href="classipc_1_1util_1_1Process__credentials.html#a18c901aeeed11c91afcc6379260f02a5">util::Process_credentials::own_process_id</a>());</div>
<div class="line"><a id="l01444" name="l01444"></a><span class="lineno"> 1444</span>          claimed_own_proc_creds.setUserId(<a class="code hl_function" href="classipc_1_1util_1_1Process__credentials.html#a9a14d2788f0aaf91042206d5f6e5cabd">util::Process_credentials::own_user_id</a>());</div>
<div class="line"><a id="l01445" name="l01445"></a><span class="lineno"> 1445</span>          claimed_own_proc_creds.setGroupId(<a class="code hl_function" href="classipc_1_1util_1_1Process__credentials.html#a9c4074f11192a1193afb019d04753cd2">util::Process_credentials::own_group_id</a>());</div>
<div class="line"><a id="l01446" name="l01446"></a><span class="lineno"> 1446</span>          <span class="comment">// Our ClientApp::m_name (srv has list of allowed ones):</span></div>
<div class="line"><a id="l01447" name="l01447"></a><span class="lineno"> 1447</span>          msg_root.initOwnApp().setName(Base::cli_app_ptr()-&gt;m_name);</div>
<div class="line"><a id="l01448" name="l01448"></a><span class="lineno"> 1448</span> </div>
<div class="line"><a id="l01449" name="l01449"></a><span class="lineno"> 1449</span>          <span class="comment">// Synchronously, non-blockingly, can&#39;t-would-blockingly send it.  This can fail (it will log WARNING if so).</span></div>
<div class="line"><a id="l01450" name="l01450"></a><span class="lineno"> 1450</span>          <span class="keyword">auto</span> on_log_in_rsp_func</div>
<div class="line"><a id="l01451" name="l01451"></a><span class="lineno"> 1451</span>            = [<span class="keyword">this</span>, init_channels_by_cli_req_pre_sized, mdt_from_srv_or_null, init_channels_by_srv_req]</div>
<div class="line"><a id="l01452" name="l01452"></a><span class="lineno"> 1452</span>                (<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; log_in_rsp) <span class="keyword">mutable</span></div>
<div class="line"><a id="l01453" name="l01453"></a><span class="lineno"> 1453</span>          {</div>
<div class="line"><a id="l01454" name="l01454"></a><span class="lineno"> 1454</span>            <span class="comment">// We are in thread Wc (as in above error handler).</span></div>
<div class="line"><a id="l01455" name="l01455"></a><span class="lineno"> 1455</span>            m_async_worker.post([<span class="keyword">this</span>, log_in_rsp = std::move(log_in_rsp),</div>
<div class="line"><a id="l01456" name="l01456"></a><span class="lineno"> 1456</span>                                 init_channels_by_cli_req_pre_sized, mdt_from_srv_or_null, init_channels_by_srv_req]</div>
<div class="line"><a id="l01457" name="l01457"></a><span class="lineno"> 1457</span>                                  () <span class="keyword">mutable</span></div>
<div class="line"><a id="l01458" name="l01458"></a><span class="lineno"> 1458</span>            {</div>
<div class="line"><a id="l01459" name="l01459"></a><span class="lineno"> 1459</span>              on_master_channel_log_in_rsp(std::move(log_in_rsp),</div>
<div class="line"><a id="l01460" name="l01460"></a><span class="lineno"> 1460</span>                                           init_channels_by_cli_req_pre_sized,</div>
<div class="line"><a id="l01461" name="l01461"></a><span class="lineno"> 1461</span>                                           mdt_from_srv_or_null,</div>
<div class="line"><a id="l01462" name="l01462"></a><span class="lineno"> 1462</span>                                           init_channels_by_srv_req);</div>
<div class="line"><a id="l01463" name="l01463"></a><span class="lineno"> 1463</span>            });</div>
<div class="line"><a id="l01464" name="l01464"></a><span class="lineno"> 1464</span>          };</div>
<div class="line"><a id="l01465" name="l01465"></a><span class="lineno"> 1465</span>          <span class="comment">/* Maintenance note: (Background: &quot;CONNECTING state and asynchronicity&quot; in class doc header.)</span></div>
<div class="line"><a id="l01466" name="l01466"></a><span class="lineno"> 1466</span><span class="comment">           * We could use sync_request() here, leading to simpler code.  As mentioned that doc-section, though,</span></div>
<div class="line"><a id="l01467" name="l01467"></a><span class="lineno"> 1467</span><span class="comment">           * leaving it in -&gt;async_request() form for when/if *this (in some form) becomes network-enabled.</span></div>
<div class="line"><a id="l01468" name="l01468"></a><span class="lineno"> 1468</span><span class="comment">           * We already have the async error handling all set-up and wouldn&#39;t need to change write much more, etc. */</span></div>
<div class="line"><a id="l01469" name="l01469"></a><span class="lineno"> 1469</span>          <span class="keywordflow">if</span> (!m_master_channel-&gt;async_request(log_in_req_msg, <span class="keyword">nullptr</span>, <span class="keyword">nullptr</span>, <span class="comment">// One-off (single response).</span></div>
<div class="line"><a id="l01470" name="l01470"></a><span class="lineno"> 1470</span>                                               std::move(on_log_in_rsp_func), &amp;err_code))</div>
<div class="line"><a id="l01471" name="l01471"></a><span class="lineno"> 1471</span>          {</div>
<div class="line"><a id="l01472" name="l01472"></a><span class="lineno"> 1472</span>            <span class="comment">/* The docs say async_request() returns false if:</span></div>
<div class="line"><a id="l01473" name="l01473"></a><span class="lineno"> 1473</span><span class="comment">             * &quot;`msg` with-handle, but #Owner_channel has no handles pipe; an #Error_code was previously emitted</span></div>
<div class="line"><a id="l01474" name="l01474"></a><span class="lineno"> 1474</span><span class="comment">             * via on-error handler; async_end_sending() has already been called.&quot;  Only the middle one is possible in</span></div>
<div class="line"><a id="l01475" name="l01475"></a><span class="lineno"> 1475</span><span class="comment">             * our case.  on_master_channel_error() shall issue m_conn_on_done_func_or_empty(truthy) in our stead. */</span></div>
<div class="line"><a id="l01476" name="l01476"></a><span class="lineno"> 1476</span>            FLOW_LOG_TRACE(<span class="stringliteral">&quot;send() synchronously failed; must be an error situation.  Error handler should &quot;</span></div>
<div class="line"><a id="l01477" name="l01477"></a><span class="lineno"> 1477</span>                           <span class="stringliteral">&quot;catch it shortly or has already caught it.&quot;</span>);</div>
<div class="line"><a id="l01478" name="l01478"></a><span class="lineno"> 1478</span>            <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// &lt;-- Attention!  Async-op started (error handler coming).</span></div>
<div class="line"><a id="l01479" name="l01479"></a><span class="lineno"> 1479</span>          }</div>
<div class="line"><a id="l01480" name="l01480"></a><span class="lineno"> 1480</span>          <span class="comment">// else</span></div>
<div class="line"><a id="l01481" name="l01481"></a><span class="lineno"> 1481</span> </div>
<div class="line"><a id="l01482" name="l01482"></a><span class="lineno"> 1482</span>          <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01483" name="l01483"></a><span class="lineno"> 1483</span>          {</div>
<div class="line"><a id="l01484" name="l01484"></a><span class="lineno"> 1484</span>            FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Log-in request issued.  Awaiting log-in response.  &quot;</span></div>
<div class="line"><a id="l01485" name="l01485"></a><span class="lineno"> 1485</span>                           <span class="stringliteral">&quot;CONNECTING state still in effect.&quot;</span>);</div>
<div class="line"><a id="l01486" name="l01486"></a><span class="lineno"> 1486</span>            <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// &lt;-- Attention!  Async-op started (completion handler coming).</span></div>
<div class="line"><a id="l01487" name="l01487"></a><span class="lineno"> 1487</span>          }</div>
<div class="line"><a id="l01488" name="l01488"></a><span class="lineno"> 1488</span>          <span class="comment">// else</span></div>
<div class="line"><a id="l01489" name="l01489"></a><span class="lineno"> 1489</span> </div>
<div class="line"><a id="l01490" name="l01490"></a><span class="lineno"> 1490</span>          <span class="comment">/* Back to the drawing board (no async-op started); and while at the drawing board the master channel is</span></div>
<div class="line"><a id="l01491" name="l01491"></a><span class="lineno"> 1491</span><span class="comment">           * null; so make it so. err_code is set. */</span></div>
<div class="line"><a id="l01492" name="l01492"></a><span class="lineno"> 1492</span>          m_master_channel.reset();</div>
<div class="line"><a id="l01493" name="l01493"></a><span class="lineno"> 1493</span>          <span class="comment">// Fall through.</span></div>
<div class="line"><a id="l01494" name="l01494"></a><span class="lineno"> 1494</span>        } <span class="comment">// if (!err_code) [from sock_stm.sync_connect()] (might have become truthy inside though)</span></div>
<div class="line"><a id="l01495" name="l01495"></a><span class="lineno"> 1495</span>        <span class="keywordflow">else</span> <span class="comment">// if (err_code) [from m_master_channel-&gt;async_request()]</span></div>
<div class="line"><a id="l01496" name="l01496"></a><span class="lineno"> 1496</span>        {</div>
<div class="line"><a id="l01497" name="l01497"></a><span class="lineno"> 1497</span>          FLOW_LOG_WARNING</div>
<div class="line"><a id="l01498" name="l01498"></a><span class="lineno"> 1498</span>            (<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Master channel Native_socket_stream &quot;</span></div>
<div class="line"><a id="l01499" name="l01499"></a><span class="lineno"> 1499</span>             <span class="stringliteral">&quot;sync-connect to [&quot;</span> &lt;&lt; acc_name &lt;&lt; <span class="stringliteral">&quot;] failed (code &quot;</span></div>
<div class="line"><a id="l01500" name="l01500"></a><span class="lineno"> 1500</span>             <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code.message() &lt;&lt; <span class="stringliteral">&quot;]).  Will go back to NULL state and report &quot;</span></div>
<div class="line"><a id="l01501" name="l01501"></a><span class="lineno"> 1501</span>             <span class="stringliteral">&quot;to user via on-async-connect handler.&quot;</span>);</div>
<div class="line"><a id="l01502" name="l01502"></a><span class="lineno"> 1502</span>          <span class="comment">// Fall through.</span></div>
<div class="line"><a id="l01503" name="l01503"></a><span class="lineno"> 1503</span>        }</div>
<div class="line"><a id="l01504" name="l01504"></a><span class="lineno"> 1504</span>      } <span class="comment">// if (!err_code) [from: srv_namespace_mv -&gt; `pid` conversion] (might have become truthy inside though)</span></div>
<div class="line"><a id="l01505" name="l01505"></a><span class="lineno"> 1505</span>      <span class="comment">// else if (err_code) { Fall through. }</span></div>
<div class="line"><a id="l01506" name="l01506"></a><span class="lineno"> 1506</span>    } <span class="comment">// if (!err_code) [from: reading srv_namespace_mv from CNS file] (might have become truthy inside though)</span></div>
<div class="line"><a id="l01507" name="l01507"></a><span class="lineno"> 1507</span>    <span class="comment">// else if (err_code) { Fall through. }</span></div>
<div class="line"><a id="l01508" name="l01508"></a><span class="lineno"> 1508</span> </div>
<div class="line"><a id="l01509" name="l01509"></a><span class="lineno"> 1509</span>    assert(err_code &amp;&amp; <span class="stringliteral">&quot;All code paths except async-op-starting ones (above) must have led to a truthy Error_code.&quot;</span>);</div>
<div class="line"><a id="l01510" name="l01510"></a><span class="lineno"> 1510</span> </div>
<div class="line"><a id="l01511" name="l01511"></a><span class="lineno"> 1511</span>    <span class="comment">// Can emit.</span></div>
<div class="line"><a id="l01512" name="l01512"></a><span class="lineno"> 1512</span>    assert((m_state == State::S_CONNECTING)</div>
<div class="line"><a id="l01513" name="l01513"></a><span class="lineno"> 1513</span>           &amp;&amp; <span class="stringliteral">&quot;A lot of (albeit synchronous) code above... just making sure.&quot;</span>);</div>
<div class="line"><a id="l01514" name="l01514"></a><span class="lineno"> 1514</span>    assert((!m_conn_on_done_func_or_empty.empty())</div>
<div class="line"><a id="l01515" name="l01515"></a><span class="lineno"> 1515</span>           &amp;&amp; <span class="stringliteral">&quot;m_conn_on_done_func_or_empty can only be emptied upon executing it.&quot;</span>);</div>
<div class="line"><a id="l01516" name="l01516"></a><span class="lineno"> 1516</span> </div>
<div class="line"><a id="l01517" name="l01517"></a><span class="lineno"> 1517</span>    m_state = State::S_NULL;</div>
<div class="line"><a id="l01518" name="l01518"></a><span class="lineno"> 1518</span> </div>
<div class="line"><a id="l01519" name="l01519"></a><span class="lineno"> 1519</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Reporting connect failed &quot;</span></div>
<div class="line"><a id="l01520" name="l01520"></a><span class="lineno"> 1520</span>                   <span class="stringliteral">&quot;(it was right inside async_connect(), before actual socket-stream connect).  Executing handler.&quot;</span>);</div>
<div class="line"><a id="l01521" name="l01521"></a><span class="lineno"> 1521</span>    invoke_conn_on_done_func(err_code);</div>
<div class="line"><a id="l01522" name="l01522"></a><span class="lineno"> 1522</span> </div>
<div class="line"><a id="l01523" name="l01523"></a><span class="lineno"> 1523</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l01524" name="l01524"></a><span class="lineno"> 1524</span>  }; <span class="comment">// const auto do_func =</span></div>
<div class="line"><a id="l01525" name="l01525"></a><span class="lineno"> 1525</span> </div>
<div class="line"><a id="l01526" name="l01526"></a><span class="lineno"> 1526</span>  <span class="comment">// We post all real work onto our thread W.</span></div>
<div class="line"><a id="l01527" name="l01527"></a><span class="lineno"> 1527</span> </div>
<div class="line"><a id="l01528" name="l01528"></a><span class="lineno"> 1528</span>  <span class="keywordtype">bool</span> result;</div>
<div class="line"><a id="l01529" name="l01529"></a><span class="lineno"> 1529</span>  m_async_worker.post([&amp;]() { result = do_func(); },</div>
<div class="line"><a id="l01530" name="l01530"></a><span class="lineno"> 1530</span>                      Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION);</div>
<div class="line"><a id="l01531" name="l01531"></a><span class="lineno"> 1531</span> </div>
<div class="line"><a id="l01532" name="l01532"></a><span class="lineno"> 1532</span>  <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l01533" name="l01533"></a><span class="lineno"> 1533</span>} <span class="comment">// Client_session_impl::async_connect()</span></div>
<div class="line"><a id="l01534" name="l01534"></a><span class="lineno"> 1534</span> </div>
<div class="line"><a id="l01535" name="l01535"></a><span class="lineno"> 1535</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01536" name="l01536"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a139fde1cf8dc2c64276b9eb25b35bcee"> 1536</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::on_master_channel_log_in_rsp</div>
<div class="line"><a id="l01537" name="l01537"></a><span class="lineno"> 1537</span>       (<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; log_in_rsp, <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a>* init_channels_by_cli_req_pre_sized,</div>
<div class="line"><a id="l01538" name="l01538"></a><span class="lineno"> 1538</span>        <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a>* mdt_from_srv_or_null, <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a>* init_channels_by_srv_req)</div>
<div class="line"><a id="l01539" name="l01539"></a><span class="lineno"> 1539</span>{</div>
<div class="line"><a id="l01540" name="l01540"></a><span class="lineno"> 1540</span>  <span class="keyword">using </span>boost::shared_ptr;</div>
<div class="line"><a id="l01541" name="l01541"></a><span class="lineno"> 1541</span>  <span class="keyword">using </span>boost::make_shared;</div>
<div class="line"><a id="l01542" name="l01542"></a><span class="lineno"> 1542</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l01543" name="l01543"></a><span class="lineno"> 1543</span> </div>
<div class="line"><a id="l01544" name="l01544"></a><span class="lineno"> 1544</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01545" name="l01545"></a><span class="lineno"> 1545</span> </div>
<div class="line"><a id="l01546" name="l01546"></a><span class="lineno"> 1546</span>  <span class="comment">/* Cool; we got the response to the log-in request we sent.  m_master_channel is actually now in logged-in phase</span></div>
<div class="line"><a id="l01547" name="l01547"></a><span class="lineno"> 1547</span><span class="comment">   * already; but we aren&#39;t home free quite yet.  Firstly there&#39;s a datum in there we need; but also -- as documented</span></div>
<div class="line"><a id="l01548" name="l01548"></a><span class="lineno"> 1548</span><span class="comment">   * in struc::Channel doc headers -- the log-in response is considered valid by it (in terms of moving to</span></div>
<div class="line"><a id="l01549" name="l01549"></a><span class="lineno"> 1549</span><span class="comment">   * logged-in phase) as long as it, in fact, responds to the request; but there&#39;s no check for a *particular*</span></div>
<div class="line"><a id="l01550" name="l01550"></a><span class="lineno"> 1550</span><span class="comment">   * response message, just as long as it&#39;s a response.  So that&#39;s on us, and if that&#39;s not right, then we can</span></div>
<div class="line"><a id="l01551" name="l01551"></a><span class="lineno"> 1551</span><span class="comment">   * still fail our CONNECTING-&gt;PEER state transition and go to NULL instead after all. */</span></div>
<div class="line"><a id="l01552" name="l01552"></a><span class="lineno"> 1552</span> </div>
<div class="line"><a id="l01553" name="l01553"></a><span class="lineno"> 1553</span>  <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code; <span class="comment">// Success to start but...</span></div>
<div class="line"><a id="l01554" name="l01554"></a><span class="lineno"> 1554</span>  <span class="comment">// (Initialize to avoid -- incorrect -- warning.)</span></div>
<div class="line"><a id="l01555" name="l01555"></a><span class="lineno"> 1555</span>  <span class="keywordtype">size_t</span> n_init_channels = 0; <span class="comment">// If successful log-in (so far) this&#39;ll be set to how many init channels we&#39;ll expect.</span></div>
<div class="line"><a id="l01556" name="l01556"></a><span class="lineno"> 1556</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a> mdt_from_srv; <span class="comment">// If successful log-in (so far) this&#39;ll be set to eventual *mdt_from_srv_or_null result.</span></div>
<div class="line"><a id="l01557" name="l01557"></a><span class="lineno"> 1557</span>  <span class="keyword">const</span> <span class="keyword">auto</span>&amp; body_root = log_in_rsp-&gt;body_root();</div>
<div class="line"><a id="l01558" name="l01558"></a><span class="lineno"> 1558</span>  <span class="keywordflow">if</span> (!body_root.isLogInRsp())</div>
<div class="line"><a id="l01559" name="l01559"></a><span class="lineno"> 1559</span>  {</div>
<div class="line"><a id="l01560" name="l01560"></a><span class="lineno"> 1560</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Log-in response received, but it is &quot;</span></div>
<div class="line"><a id="l01561" name="l01561"></a><span class="lineno"> 1561</span>                     <span class="stringliteral">&quot;not the expected LogInRsp message -- other side misbehaved?  Will go back to NULL &quot;</span></div>
<div class="line"><a id="l01562" name="l01562"></a><span class="lineno"> 1562</span>                     <span class="stringliteral">&quot;state and report to user via on-async-connect handler.&quot;</span>);</div>
<div class="line"><a id="l01563" name="l01563"></a><span class="lineno"> 1563</span>    err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa866090a4d042120126722b4daf1ecc33">error::Code::S_CLIENT_MASTER_LOG_IN_RESPONSE_BAD</a>;</div>
<div class="line"><a id="l01564" name="l01564"></a><span class="lineno"> 1564</span>  }</div>
<div class="line"><a id="l01565" name="l01565"></a><span class="lineno"> 1565</span>  <span class="keywordflow">else</span> <span class="comment">// if (isLogInRsp())</span></div>
<div class="line"><a id="l01566" name="l01566"></a><span class="lineno"> 1566</span>  {</div>
<div class="line"><a id="l01567" name="l01567"></a><span class="lineno"> 1567</span>    <span class="keyword">const</span> <span class="keyword">auto</span> log_in_rsp_root = body_root.getLogInRsp();</div>
<div class="line"><a id="l01568" name="l01568"></a><span class="lineno"> 1568</span> </div>
<div class="line"><a id="l01569" name="l01569"></a><span class="lineno"> 1569</span>    <span class="comment">/* Please see similar code on server side; they will have made the same check before issuing the LogInRsp to us.</span></div>
<div class="line"><a id="l01570" name="l01570"></a><span class="lineno"> 1570</span><span class="comment">     * Protocol-negotiation occurs *here*, before any further fields are interpreted. */</span></div>
<div class="line"><a id="l01571" name="l01571"></a><span class="lineno"> 1571</span>    <span class="keyword">const</span> <span class="keyword">auto</span> proto_neg_root = log_in_rsp_root.getProtocolNegotiationToClient();</div>
<div class="line"><a id="l01572" name="l01572"></a><span class="lineno"> 1572</span>    m_protocol_negotiator.compute_negotiated_proto_ver(proto_neg_root.getMaxProtoVer(), &amp;err_code);</div>
<div class="line"><a id="l01573" name="l01573"></a><span class="lineno"> 1573</span>    <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01574" name="l01574"></a><span class="lineno"> 1574</span>    {</div>
<div class="line"><a id="l01575" name="l01575"></a><span class="lineno"> 1575</span>      m_protocol_negotiator_aux.compute_negotiated_proto_ver(proto_neg_root.getMaxProtoVerAux(), &amp;err_code);</div>
<div class="line"><a id="l01576" name="l01576"></a><span class="lineno"> 1576</span>      <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01577" name="l01577"></a><span class="lineno"> 1577</span>      {</div>
<div class="line"><a id="l01578" name="l01578"></a><span class="lineno"> 1578</span>        <span class="comment">/* As of this writing there is only protocol version 1.  In the future, if we add more versions *and*</span></div>
<div class="line"><a id="l01579" name="l01579"></a><span class="lineno"> 1579</span><span class="comment">         * decide to be backwards-compatible with older versions, then this is the point from which one knows</span></div>
<div class="line"><a id="l01580" name="l01580"></a><span class="lineno"> 1580</span><span class="comment">         * which protocol-version to speak (query m_protocol_negotiator.negotiated_proto_ver(); other Session</span></div>
<div class="line"><a id="l01581" name="l01581"></a><span class="lineno"> 1581</span><span class="comment">         * hierarchies can query m_protocol_negotiator_aux.&lt;same&gt;()). */</span></div>
<div class="line"><a id="l01582" name="l01582"></a><span class="lineno"> 1582</span> </div>
<div class="line"><a id="l01583" name="l01583"></a><span class="lineno"> 1583</span>        <span class="keyword">const</span> <span class="keyword">auto</span> n_init_channels_by_srv_req = log_in_rsp_root.getNumInitChannelsBySrvReq();</div>
<div class="line"><a id="l01584" name="l01584"></a><span class="lineno"> 1584</span>        <span class="keywordflow">if</span> ((n_init_channels_by_srv_req != 0) &amp;&amp; (!init_channels_by_srv_req))</div>
<div class="line"><a id="l01585" name="l01585"></a><span class="lineno"> 1585</span>        {</div>
<div class="line"><a id="l01586" name="l01586"></a><span class="lineno"> 1586</span>          FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Log-in response received, &quot;</span></div>
<div class="line"><a id="l01587" name="l01587"></a><span class="lineno"> 1587</span>                           <span class="stringliteral">&quot;and it is the expected LogInRsp message; but this side passed null container for &quot;</span></div>
<div class="line"><a id="l01588" name="l01588"></a><span class="lineno"> 1588</span>                           <span class="stringliteral">&quot;init-channels-by-srv-request, while server indicates it will open &quot;</span></div>
<div class="line"><a id="l01589" name="l01589"></a><span class="lineno"> 1589</span>                           <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; n_init_channels_by_srv_req &lt;&lt; <span class="stringliteral">&quot;] of them -- this or other side misbehaved?  &quot;</span></div>
<div class="line"><a id="l01590" name="l01590"></a><span class="lineno"> 1590</span>                           <span class="stringliteral">&quot;Will go back to NULL state and report to user via on-async-connect handler.&quot;</span>);</div>
<div class="line"><a id="l01591" name="l01591"></a><span class="lineno"> 1591</span>          err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fac416e988563e44bf15fc6a81743eef53">error::Code::S_INVALID_ARGUMENT</a>;</div>
<div class="line"><a id="l01592" name="l01592"></a><span class="lineno"> 1592</span>        }</div>
<div class="line"><a id="l01593" name="l01593"></a><span class="lineno"> 1593</span>        <span class="keywordflow">else</span> <span class="comment">// if (n_init_channels_by_srv_req is fine)</span></div>
<div class="line"><a id="l01594" name="l01594"></a><span class="lineno"> 1594</span>        {</div>
<div class="line"><a id="l01595" name="l01595"></a><span class="lineno"> 1595</span>          <span class="keyword">auto</span> cli_namespace_mv = <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(<span class="keywordtype">string</span>(log_in_rsp_root.getClientNamespace()));</div>
<div class="line"><a id="l01596" name="l01596"></a><span class="lineno"> 1596</span>          <span class="keywordflow">if</span> (cli_namespace_mv.empty() || (cli_namespace_mv == <a class="code hl_variable" href="classipc_1_1util_1_1Shared__name.html#a43205a00865429c1bef6c7896816bf5c">Shared_name::S_SENTINEL</a>))</div>
<div class="line"><a id="l01597" name="l01597"></a><span class="lineno"> 1597</span>          {</div>
<div class="line"><a id="l01598" name="l01598"></a><span class="lineno"> 1598</span>            FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Log-in response received, &quot;</span></div>
<div class="line"><a id="l01599" name="l01599"></a><span class="lineno"> 1599</span>                             <span class="stringliteral">&quot;and it is the expected LogInRsp message; but the cli-namespace &quot;</span></div>
<div class="line"><a id="l01600" name="l01600"></a><span class="lineno"> 1600</span>                             <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; cli_namespace_mv &lt;&lt; <span class="stringliteral">&quot;] therein is illegal -- other side misbehaved?  Will go &quot;</span></div>
<div class="line"><a id="l01601" name="l01601"></a><span class="lineno"> 1601</span>                             <span class="stringliteral">&quot;back to NULL state and report to user via on-async-connect handler.&quot;</span>);</div>
<div class="line"><a id="l01602" name="l01602"></a><span class="lineno"> 1602</span>            err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa866090a4d042120126722b4daf1ecc33">error::Code::S_CLIENT_MASTER_LOG_IN_RESPONSE_BAD</a>;</div>
<div class="line"><a id="l01603" name="l01603"></a><span class="lineno"> 1603</span>          }</div>
<div class="line"><a id="l01604" name="l01604"></a><span class="lineno"> 1604</span>          <span class="keywordflow">else</span> <span class="comment">// if (all good)</span></div>
<div class="line"><a id="l01605" name="l01605"></a><span class="lineno"> 1605</span>          {</div>
<div class="line"><a id="l01606" name="l01606"></a><span class="lineno"> 1606</span>            Base::set_cli_namespace(std::move(cli_namespace_mv));</div>
<div class="line"><a id="l01607" name="l01607"></a><span class="lineno"> 1607</span>            <span class="comment">// cli_namespace_mv is now hosed.</span></div>
<div class="line"><a id="l01608" name="l01608"></a><span class="lineno"> 1608</span> </div>
<div class="line"><a id="l01609" name="l01609"></a><span class="lineno"> 1609</span>            <span class="comment">// All is cool; can compute this now.</span></div>
<div class="line"><a id="l01610" name="l01610"></a><span class="lineno"> 1610</span>            n_init_channels = n_init_channels_by_srv_req + (init_channels_by_cli_req_pre_sized</div>
<div class="line"><a id="l01611" name="l01611"></a><span class="lineno"> 1611</span>                                                              ? init_channels_by_cli_req_pre_sized-&gt;size()</div>
<div class="line"><a id="l01612" name="l01612"></a><span class="lineno"> 1612</span>                                                              : 0);</div>
<div class="line"><a id="l01613" name="l01613"></a><span class="lineno"> 1613</span> </div>
<div class="line"><a id="l01614" name="l01614"></a><span class="lineno"> 1614</span>            FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Log-in response received, and &quot;</span></div>
<div class="line"><a id="l01615" name="l01615"></a><span class="lineno"> 1615</span>                          <span class="stringliteral">&quot;it is the expected LogInRsp message; cli-namespace [&quot;</span> &lt;&lt; Base::cli_namespace() &lt;&lt; <span class="stringliteral">&quot;] &quot;</span></div>
<div class="line"><a id="l01616" name="l01616"></a><span class="lineno"> 1616</span>                          <span class="stringliteral">&quot;received and saved.  Init-channel count expected is [&quot;</span> &lt;&lt; n_init_channels &lt;&lt; <span class="stringliteral">&quot;]; of these &quot;</span></div>
<div class="line"><a id="l01617" name="l01617"></a><span class="lineno"> 1617</span>                          <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; n_init_channels_by_srv_req &lt;&lt; <span class="stringliteral">&quot;] requested by opposing server.  &quot;</span></div>
<div class="line"><a id="l01618" name="l01618"></a><span class="lineno"> 1618</span>                          <span class="stringliteral">&quot;If 0: Will go to PEER state and report to user via on-async-connect handler.  &quot;</span></div>
<div class="line"><a id="l01619" name="l01619"></a><span class="lineno"> 1619</span>                          <span class="stringliteral">&quot;Else: Will await that many open-channel-to-client requests with the init-channel info.&quot;</span>);</div>
<div class="line"><a id="l01620" name="l01620"></a><span class="lineno"> 1620</span> </div>
<div class="line"><a id="l01621" name="l01621"></a><span class="lineno"> 1621</span>            <span class="keywordflow">if</span> (mdt_from_srv_or_null)</div>
<div class="line"><a id="l01622" name="l01622"></a><span class="lineno"> 1622</span>            {</div>
<div class="line"><a id="l01623" name="l01623"></a><span class="lineno"> 1623</span>              <span class="comment">/* They&#39;re interested in the metadata from server; we can now fish it out (but only set</span></div>
<div class="line"><a id="l01624" name="l01624"></a><span class="lineno"> 1624</span><span class="comment">               * *mdt_from_srv_or_null when invoking handler on success as promised; untouched otherwise as promised).</span></div>
<div class="line"><a id="l01625" name="l01625"></a><span class="lineno"> 1625</span><span class="comment">               * So prepare the result.</span></div>
<div class="line"><a id="l01626" name="l01626"></a><span class="lineno"> 1626</span><span class="comment">               *</span></div>
<div class="line"><a id="l01627" name="l01627"></a><span class="lineno"> 1627</span><span class="comment">               * Use the same technique as when emitting `mdt` in on_master_channel_open_channel_req(); omitting</span></div>
<div class="line"><a id="l01628" name="l01628"></a><span class="lineno"> 1628</span><span class="comment">               * comments. */</span></div>
<div class="line"><a id="l01629" name="l01629"></a><span class="lineno"> 1629</span>              <span class="keyword">struct </span>Rsp_and_mdt_reader</div>
<div class="line"><a id="l01630" name="l01630"></a><span class="lineno"> 1630</span>              {</div>
<div class="line"><a id="l01631" name="l01631"></a><span class="lineno"> 1631</span>                <span class="keyword">typename</span> Mdt_reader_ptr::element_type m_mdt_reader;</div>
<div class="line"><a id="l01632" name="l01632"></a><span class="lineno"> 1632</span>                <span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr m_rsp;</div>
<div class="line"><a id="l01633" name="l01633"></a><span class="lineno"> 1633</span>              };</div>
<div class="line"><a id="l01634" name="l01634"></a><span class="lineno"> 1634</span>              shared_ptr&lt;Rsp_and_mdt_reader&gt; rsp_and_mdt(<span class="keyword">new</span> Rsp_and_mdt_reader</div>
<div class="line"><a id="l01635" name="l01635"></a><span class="lineno"> 1635</span>                                                               { log_in_rsp_root.getMetadata(),</div>
<div class="line"><a id="l01636" name="l01636"></a><span class="lineno"> 1636</span>                                                                  std::move(log_in_rsp) });</div>
<div class="line"><a id="l01637" name="l01637"></a><span class="lineno"> 1637</span>              <span class="comment">// (log_in_rsp is now hosed.)</span></div>
<div class="line"><a id="l01638" name="l01638"></a><span class="lineno"> 1638</span>              mdt_from_srv = <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a>(std::move(rsp_and_mdt), &amp;rsp_and_mdt-&gt;m_mdt_reader);</div>
<div class="line"><a id="l01639" name="l01639"></a><span class="lineno"> 1639</span>            } <span class="comment">// if (mdt_from_srv_or_null)</span></div>
<div class="line"><a id="l01640" name="l01640"></a><span class="lineno"> 1640</span>            <span class="comment">// else if (!mdt_from_srv_or_null) { Leave mdt_from_srv null too. }</span></div>
<div class="line"><a id="l01641" name="l01641"></a><span class="lineno"> 1641</span>          } <span class="comment">// if (all good, continue on path to PEER state)</span></div>
<div class="line"><a id="l01642" name="l01642"></a><span class="lineno"> 1642</span>        } <span class="comment">// else if (n_init_channels_by_srv_req is fine) (but err_code may have become truthy inside)</span></div>
<div class="line"><a id="l01643" name="l01643"></a><span class="lineno"> 1643</span>      } <span class="comment">// else if (!err_code from m_protocol_negotiator_aux.compute_negotiated_proto_ver()) (ditto re. err_code)</span></div>
<div class="line"><a id="l01644" name="l01644"></a><span class="lineno"> 1644</span>    } <span class="comment">// else if (!err_code from m_protocol_negotiator.compute_negotiated_proto_ver()) (ditto re. err_code)</span></div>
<div class="line"><a id="l01645" name="l01645"></a><span class="lineno"> 1645</span>  } <span class="comment">// if (isLogInRsp())</span></div>
<div class="line"><a id="l01646" name="l01646"></a><span class="lineno"> 1646</span> </div>
<div class="line"><a id="l01647" name="l01647"></a><span class="lineno"> 1647</span>  assert((m_state == State::S_CONNECTING)</div>
<div class="line"><a id="l01648" name="l01648"></a><span class="lineno"> 1648</span>         &amp;&amp; <span class="stringliteral">&quot;Once master-channel is up, there are 2 ways to exit CONNECTING state: 1, &quot;</span></div>
<div class="line"><a id="l01649" name="l01649"></a><span class="lineno"> 1649</span>              <span class="stringliteral">&quot;on_master_channel_log_in_rsp(): we are it; 2, on_master_channel_error(), but if that has been &quot;</span></div>
<div class="line"><a id="l01650" name="l01650"></a><span class="lineno"> 1650</span>              <span class="stringliteral">&quot;called already, then we (on_master_channel_log_in_rsp()) should not have been.&quot;</span>);</div>
<div class="line"><a id="l01651" name="l01651"></a><span class="lineno"> 1651</span>  assert((!m_conn_on_done_func_or_empty.empty())</div>
<div class="line"><a id="l01652" name="l01652"></a><span class="lineno"> 1652</span>         &amp;&amp; <span class="stringliteral">&quot;m_conn_on_done_func_or_empty can only be emptied upon executing it.&quot;</span>);</div>
<div class="line"><a id="l01653" name="l01653"></a><span class="lineno"> 1653</span> </div>
<div class="line"><a id="l01654" name="l01654"></a><span class="lineno"> 1654</span>  <span class="keywordflow">if</span> (err_code)</div>
<div class="line"><a id="l01655" name="l01655"></a><span class="lineno"> 1655</span>  {</div>
<div class="line"><a id="l01656" name="l01656"></a><span class="lineno"> 1656</span>    <span class="comment">/* Wrong log-in response, so as far as they&#39;re concerned, it&#39;s no different from the async-connect failing.  Back</span></div>
<div class="line"><a id="l01657" name="l01657"></a><span class="lineno"> 1657</span><span class="comment">     * to the drawing board; and while at the drawing board the master channel is null.  err_code is set. */</span></div>
<div class="line"><a id="l01658" name="l01658"></a><span class="lineno"> 1658</span>    m_master_channel.reset();</div>
<div class="line"><a id="l01659" name="l01659"></a><span class="lineno"> 1659</span>    m_state = State::S_NULL;</div>
<div class="line"><a id="l01660" name="l01660"></a><span class="lineno"> 1660</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Master channel Native_socket_stream &quot;</span></div>
<div class="line"><a id="l01661" name="l01661"></a><span class="lineno"> 1661</span>                   <span class="stringliteral">&quot;async-connect succeded, but the log-in within the resulting channel failed &quot;</span></div>
<div class="line"><a id="l01662" name="l01662"></a><span class="lineno"> 1662</span>                   <span class="stringliteral">&quot;(see above for details).  Executing handler.&quot;</span>);</div>
<div class="line"><a id="l01663" name="l01663"></a><span class="lineno"> 1663</span>    invoke_conn_on_done_func(err_code);</div>
<div class="line"><a id="l01664" name="l01664"></a><span class="lineno"> 1664</span> </div>
<div class="line"><a id="l01665" name="l01665"></a><span class="lineno"> 1665</span>    <span class="comment">// That&#39;s it.  They can try async_connect() again.</span></div>
<div class="line"><a id="l01666" name="l01666"></a><span class="lineno"> 1666</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01667" name="l01667"></a><span class="lineno"> 1667</span>  } <span class="comment">// if (err_code)</span></div>
<div class="line"><a id="l01668" name="l01668"></a><span class="lineno"> 1668</span> </div>
<div class="line"><a id="l01669" name="l01669"></a><span class="lineno"> 1669</span>  <span class="keywordflow">if</span> (n_init_channels == 0)</div>
<div class="line"><a id="l01670" name="l01670"></a><span class="lineno"> 1670</span>  {</div>
<div class="line"><a id="l01671" name="l01671"></a><span class="lineno"> 1671</span>    <span class="comment">// Cool -- nothing else to be done (no init-channels to open).  Emit stuff.</span></div>
<div class="line"><a id="l01672" name="l01672"></a><span class="lineno"> 1672</span> </div>
<div class="line"><a id="l01673" name="l01673"></a><span class="lineno"> 1673</span>    <span class="keywordflow">if</span> (init_channels_by_srv_req)</div>
<div class="line"><a id="l01674" name="l01674"></a><span class="lineno"> 1674</span>    {</div>
<div class="line"><a id="l01675" name="l01675"></a><span class="lineno"> 1675</span>      init_channels_by_srv_req-&gt;clear();</div>
<div class="line"><a id="l01676" name="l01676"></a><span class="lineno"> 1676</span>    }</div>
<div class="line"><a id="l01677" name="l01677"></a><span class="lineno"> 1677</span>    assert(((!init_channels_by_cli_req_pre_sized) || init_channels_by_cli_req_pre_sized-&gt;empty())</div>
<div class="line"><a id="l01678" name="l01678"></a><span class="lineno"> 1678</span>           &amp;&amp; <span class="stringliteral">&quot;Otherwise could n_init_channels remain 0?&quot;</span>);</div>
<div class="line"><a id="l01679" name="l01679"></a><span class="lineno"> 1679</span>    assert((<span class="keywordtype">bool</span>(mdt_from_srv_or_null) == <span class="keywordtype">bool</span>(mdt_from_srv)) &amp;&amp; <span class="stringliteral">&quot;Some logic above must be broken.&quot;</span>);</div>
<div class="line"><a id="l01680" name="l01680"></a><span class="lineno"> 1680</span>    <span class="keywordflow">if</span> (mdt_from_srv_or_null)</div>
<div class="line"><a id="l01681" name="l01681"></a><span class="lineno"> 1681</span>    {</div>
<div class="line"><a id="l01682" name="l01682"></a><span class="lineno"> 1682</span>      *mdt_from_srv_or_null = std::move(mdt_from_srv);</div>
<div class="line"><a id="l01683" name="l01683"></a><span class="lineno"> 1683</span>    }</div>
<div class="line"><a id="l01684" name="l01684"></a><span class="lineno"> 1684</span> </div>
<div class="line"><a id="l01685" name="l01685"></a><span class="lineno"> 1685</span>    <span class="comment">/* From now on we can handle passive-open-channel requests.  (They might even be cached inside</span></div>
<div class="line"><a id="l01686" name="l01686"></a><span class="lineno"> 1686</span><span class="comment">     * m_master_channel now already, and they&#39;ll be flushed right now.) */</span></div>
<div class="line"><a id="l01687" name="l01687"></a><span class="lineno"> 1687</span>    <span class="keywordtype">bool</span> ok = m_master_channel-&gt;expect_msgs(Master_structured_channel::Msg_which_in::OPEN_CHANNEL_TO_CLIENT_REQ,</div>
<div class="line"><a id="l01688" name="l01688"></a><span class="lineno"> 1688</span>                                            [<span class="keyword">this</span>](<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; open_channel_req)</div>
<div class="line"><a id="l01689" name="l01689"></a><span class="lineno"> 1689</span>    {</div>
<div class="line"><a id="l01690" name="l01690"></a><span class="lineno"> 1690</span>      <span class="comment">// We are in thread Wc (unspecified, really struc::Channel async callback thread).</span></div>
<div class="line"><a id="l01691" name="l01691"></a><span class="lineno"> 1691</span>      m_async_worker.post([<span class="keyword">this</span>, open_channel_req = std::move(open_channel_req)]() <span class="keyword">mutable</span></div>
<div class="line"><a id="l01692" name="l01692"></a><span class="lineno"> 1692</span>      {</div>
<div class="line"><a id="l01693" name="l01693"></a><span class="lineno"> 1693</span>        <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01694" name="l01694"></a><span class="lineno"> 1694</span>        on_master_channel_open_channel_req(std::move(open_channel_req));</div>
<div class="line"><a id="l01695" name="l01695"></a><span class="lineno"> 1695</span>      });</div>
<div class="line"><a id="l01696" name="l01696"></a><span class="lineno"> 1696</span>    });</div>
<div class="line"><a id="l01697" name="l01697"></a><span class="lineno"> 1697</span> </div>
<div class="line"><a id="l01698" name="l01698"></a><span class="lineno"> 1698</span>    <span class="keywordflow">if</span> (!ok)</div>
<div class="line"><a id="l01699" name="l01699"></a><span class="lineno"> 1699</span>    {</div>
<div class="line"><a id="l01700" name="l01700"></a><span class="lineno"> 1700</span>      <span class="comment">// Got hosed very recently (that logged).  on_master_channel_error() will deal with it.</span></div>
<div class="line"><a id="l01701" name="l01701"></a><span class="lineno"> 1701</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01702" name="l01702"></a><span class="lineno"> 1702</span>    }</div>
<div class="line"><a id="l01703" name="l01703"></a><span class="lineno"> 1703</span> </div>
<div class="line"><a id="l01704" name="l01704"></a><span class="lineno"> 1704</span>    m_state = State::S_PEER;</div>
<div class="line"><a id="l01705" name="l01705"></a><span class="lineno"> 1705</span> </div>
<div class="line"><a id="l01706" name="l01706"></a><span class="lineno"> 1706</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Master channel Native_socket_stream &quot;</span></div>
<div class="line"><a id="l01707" name="l01707"></a><span class="lineno"> 1707</span>                   <span class="stringliteral">&quot;async-connect succeded, and the log-in within the resulting channel succeeded.  &quot;</span></div>
<div class="line"><a id="l01708" name="l01708"></a><span class="lineno"> 1708</span>                   <span class="stringliteral">&quot;Executing handler.&quot;</span>);</div>
<div class="line"><a id="l01709" name="l01709"></a><span class="lineno"> 1709</span>    invoke_conn_on_done_func(err_code);</div>
<div class="line"><a id="l01710" name="l01710"></a><span class="lineno"> 1710</span> </div>
<div class="line"><a id="l01711" name="l01711"></a><span class="lineno"> 1711</span>    <span class="comment">// That&#39;s it.  They can proceed with session work.  (Unless subclass just did a cancel_peer_state_to_*().)</span></div>
<div class="line"><a id="l01712" name="l01712"></a><span class="lineno"> 1712</span> </div>
<div class="line"><a id="l01713" name="l01713"></a><span class="lineno"> 1713</span>    <span class="comment">/* See Session_base::Graceful_finisher doc header for all the background ever.</span></div>
<div class="line"><a id="l01714" name="l01714"></a><span class="lineno"> 1714</span><span class="comment">     *</span></div>
<div class="line"><a id="l01715" name="l01715"></a><span class="lineno"> 1715</span><span class="comment">     * Why didn&#39;t we do the following just above, after setting state to PEER?  It is indeed unusual to do something</span></div>
<div class="line"><a id="l01716" name="l01716"></a><span class="lineno"> 1716</span><span class="comment">     * in thread W *after* invoking on-done handler.  The immediate reason is the possibility of subclass,</span></div>
<div class="line"><a id="l01717" name="l01717"></a><span class="lineno"> 1717</span><span class="comment">     * not user, invoking cancel_peer_state_to_*() -- so we&#39;re not in PEER state &quot;after all&quot;: but we will</span></div>
<div class="line"><a id="l01718" name="l01718"></a><span class="lineno"> 1718</span><span class="comment">     * certainly then do it upon complete_async_connect_after_canceling_peer_state(&lt;success&gt;) reaching PEER state.</span></div>
<div class="line"><a id="l01719" name="l01719"></a><span class="lineno"> 1719</span><span class="comment">     *</span></div>
<div class="line"><a id="l01720" name="l01720"></a><span class="lineno"> 1720</span><span class="comment">     * Update: I (ygoldfel, who wrote this) am very uncomfortable with this.  This is a consequence of the, in</span></div>
<div class="line"><a id="l01721" name="l01721"></a><span class="lineno"> 1721</span><span class="comment">     * retrospect, house-of-cards-like way vanilla Client_session_impl is reused by the SHM-based guys; and that&#39;s</span></div>
<div class="line"><a id="l01722" name="l01722"></a><span class="lineno"> 1722</span><span class="comment">     * easily the biggest impl detail I regret to date -- the rest I&#39;m quite happy with really.</span></div>
<div class="line"><a id="l01723" name="l01723"></a><span class="lineno"> 1723</span><span class="comment">     * So I&#39;m addeding an assert here -- and I know as of this writing it won&#39;t trip, simply because</span></div>
<div class="line"><a id="l01724" name="l01724"></a><span class="lineno"> 1724</span><span class="comment">     * S_GRACEFUL_FINISH_REQUIRED is true only for SHM-jemalloc, and SHM-jemalloc will 100%</span></div>
<div class="line"><a id="l01725" name="l01725"></a><span class="lineno"> 1725</span><span class="comment">     * do cancel_peer_state_to_connecting() inside on_done_func() (as of this writing).  So rather than execute</span></div>
<div class="line"><a id="l01726" name="l01726"></a><span class="lineno"> 1726</span><span class="comment">     * code I am skeptical about, safety-wise (kind of thing that&#39;ll work 99.9999% of the time at least, but</span></div>
<div class="line"><a id="l01727" name="l01727"></a><span class="lineno"> 1727</span><span class="comment">     * is just too weird), I&#39;ll blow up if somehow later changes dislodge this balance.</span></div>
<div class="line"><a id="l01728" name="l01728"></a><span class="lineno"> 1728</span><span class="comment">     *</span></div>
<div class="line"><a id="l01729" name="l01729"></a><span class="lineno"> 1729</span><span class="comment">     * @todo OMG, rejigger how vanilla Client_session_impl is reused by the SHM-based subclasses: This &quot;undo PEER</span></div>
<div class="line"><a id="l01730" name="l01730"></a><span class="lineno"> 1730</span><span class="comment">     * state paradigm&quot; is just ridiculous.  We can do better than this. */</span></div>
<div class="line"><a id="l01731" name="l01731"></a><span class="lineno"> 1731</span>    <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_GRACEFUL_FINISH_REQUIRED)</div>
<div class="line"><a id="l01732" name="l01732"></a><span class="lineno"> 1732</span>    {</div>
<div class="line"><a id="l01733" name="l01733"></a><span class="lineno"> 1733</span>      assert((m_state != State::S_PEER) &amp;&amp;</div>
<div class="line"><a id="l01734" name="l01734"></a><span class="lineno"> 1734</span>             <span class="stringliteral">&quot;In practice only SHM-jemalloc should use GRACEFUL_FINISH_REQUIRED=true, and that guy should have &quot;</span></div>
<div class="line"><a id="l01735" name="l01735"></a><span class="lineno"> 1735</span>               <span class="stringliteral">&quot;canceled PEER state via cancel_peer_state_to_connecting() at best; see above comment and to-do.&quot;</span>);</div>
<div class="line"><a id="l01736" name="l01736"></a><span class="lineno"> 1736</span>      <span class="comment">// Commented out: m_graceful_finisher.emplace(get_logger(), this, &amp;m_async_worker, m_master_channel.get());</span></div>
<div class="line"><a id="l01737" name="l01737"></a><span class="lineno"> 1737</span>    }</div>
<div class="line"><a id="l01738" name="l01738"></a><span class="lineno"> 1738</span> </div>
<div class="line"><a id="l01739" name="l01739"></a><span class="lineno"> 1739</span>  } <span class="comment">// // if (n_init_channels == 0)</span></div>
<div class="line"><a id="l01740" name="l01740"></a><span class="lineno"> 1740</span>  <span class="keywordflow">else</span> <span class="comment">// if (n_init_channels != 0)</span></div>
<div class="line"><a id="l01741" name="l01741"></a><span class="lineno"> 1741</span>  {</div>
<div class="line"><a id="l01742" name="l01742"></a><span class="lineno"> 1742</span>    <span class="comment">/* Now we await openChannelToClientReq (x N) in similar fashion to PEER state,</span></div>
<div class="line"><a id="l01743" name="l01743"></a><span class="lineno"> 1743</span><span class="comment">     * except it won&#39;t be request(s) really but just the resource info/handles that normally come in such requests;</span></div>
<div class="line"><a id="l01744" name="l01744"></a><span class="lineno"> 1744</span><span class="comment">     * we need not respond.</span></div>
<div class="line"><a id="l01745" name="l01745"></a><span class="lineno"> 1745</span><span class="comment">     *</span></div>
<div class="line"><a id="l01746" name="l01746"></a><span class="lineno"> 1746</span><span class="comment">     * We have to postpone the move to PEER and firing of on_done_func() until that&#39;s done, so</span></div>
<div class="line"><a id="l01747" name="l01747"></a><span class="lineno"> 1747</span><span class="comment">     * expect open-channel requests similarly to the above; but a slightly different handler that knows to</span></div>
<div class="line"><a id="l01748" name="l01748"></a><span class="lineno"> 1748</span><span class="comment">     * finish up the async_connect() op.  Keeping comments light as it&#39;s similar to above.</span></div>
<div class="line"><a id="l01749" name="l01749"></a><span class="lineno"> 1749</span><span class="comment">     *</span></div>
<div class="line"><a id="l01750" name="l01750"></a><span class="lineno"> 1750</span><span class="comment">     * Since we promised not to touch the async out-args until success, set up a ref-counted target container</span></div>
<div class="line"><a id="l01751" name="l01751"></a><span class="lineno"> 1751</span><span class="comment">     * used as an intermediate. */</span></div>
<div class="line"><a id="l01752" name="l01752"></a><span class="lineno"> 1752</span>    <span class="keyword">auto</span> init_channels = make_shared&lt;Channels&gt;();</div>
<div class="line"><a id="l01753" name="l01753"></a><span class="lineno"> 1753</span>    init_channels-&gt;reserve(n_init_channels);</div>
<div class="line"><a id="l01754" name="l01754"></a><span class="lineno"> 1754</span> </div>
<div class="line"><a id="l01755" name="l01755"></a><span class="lineno"> 1755</span>    m_master_channel-&gt;expect_msgs</div>
<div class="line"><a id="l01756" name="l01756"></a><span class="lineno"> 1756</span>      (Master_structured_channel::Msg_which_in::OPEN_CHANNEL_TO_CLIENT_REQ,</div>
<div class="line"><a id="l01757" name="l01757"></a><span class="lineno"> 1757</span>       [<span class="keyword">this</span>, n_init_channels, init_channels = std::move(init_channels),</div>
<div class="line"><a id="l01758" name="l01758"></a><span class="lineno"> 1758</span>        init_channels_by_cli_req_pre_sized, mdt_from_srv_or_null, init_channels_by_srv_req,</div>
<div class="line"><a id="l01759" name="l01759"></a><span class="lineno"> 1759</span>        mdt_from_srv = std::move(mdt_from_srv)]</div>
<div class="line"><a id="l01760" name="l01760"></a><span class="lineno"> 1760</span>         (<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; open_channel_msg) <span class="keyword">mutable</span></div>
<div class="line"><a id="l01761" name="l01761"></a><span class="lineno"> 1761</span>    {</div>
<div class="line"><a id="l01762" name="l01762"></a><span class="lineno"> 1762</span>      m_async_worker.post</div>
<div class="line"><a id="l01763" name="l01763"></a><span class="lineno"> 1763</span>        ([<span class="keyword">this</span>, open_channel_msg = std::move(open_channel_msg),</div>
<div class="line"><a id="l01764" name="l01764"></a><span class="lineno"> 1764</span>          <span class="comment">// Copy init_channels, mdt_from_srv, as this may run 2+ times.</span></div>
<div class="line"><a id="l01765" name="l01765"></a><span class="lineno"> 1765</span>          n_init_channels, init_channels, init_channels_by_cli_req_pre_sized, mdt_from_srv_or_null,</div>
<div class="line"><a id="l01766" name="l01766"></a><span class="lineno"> 1766</span>          init_channels_by_srv_req, mdt_from_srv]</div>
<div class="line"><a id="l01767" name="l01767"></a><span class="lineno"> 1767</span>           () <span class="keyword">mutable</span></div>
<div class="line"><a id="l01768" name="l01768"></a><span class="lineno"> 1768</span>      {</div>
<div class="line"><a id="l01769" name="l01769"></a><span class="lineno"> 1769</span>        on_master_channel_init_open_channel(std::move(open_channel_msg),</div>
<div class="line"><a id="l01770" name="l01770"></a><span class="lineno"> 1770</span>                                            n_init_channels, init_channels,</div>
<div class="line"><a id="l01771" name="l01771"></a><span class="lineno"> 1771</span>                                            init_channels_by_cli_req_pre_sized, mdt_from_srv_or_null,</div>
<div class="line"><a id="l01772" name="l01772"></a><span class="lineno"> 1772</span>                                            init_channels_by_srv_req, std::move(mdt_from_srv));</div>
<div class="line"><a id="l01773" name="l01773"></a><span class="lineno"> 1773</span>      });</div>
<div class="line"><a id="l01774" name="l01774"></a><span class="lineno"> 1774</span>    });</div>
<div class="line"><a id="l01775" name="l01775"></a><span class="lineno"> 1775</span>  } <span class="comment">// else if (n_init_channels != 0)</span></div>
<div class="line"><a id="l01776" name="l01776"></a><span class="lineno"> 1776</span>} <span class="comment">// Client_session_impl::on_master_channel_log_in_rsp()</span></div>
<div class="line"><a id="l01777" name="l01777"></a><span class="lineno"> 1777</span> </div>
<div class="line"><a id="l01778" name="l01778"></a><span class="lineno"> 1778</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01779" name="l01779"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ac983066e433f143cf02cd730260e6e65"> 1779</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::on_master_channel_init_open_channel</div>
<div class="line"><a id="l01780" name="l01780"></a><span class="lineno"> 1780</span>       (<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; open_channel_msg,</div>
<div class="line"><a id="l01781" name="l01781"></a><span class="lineno"> 1781</span>        <span class="keywordtype">size_t</span> n_init_channels, <span class="keyword">const</span> boost::shared_ptr&lt;Channels&gt;&amp; init_channels_ptr,</div>
<div class="line"><a id="l01782" name="l01782"></a><span class="lineno"> 1782</span>        <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a>* init_channels_by_cli_req_pre_sized, <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a>* mdt_from_srv_or_null,</div>
<div class="line"><a id="l01783" name="l01783"></a><span class="lineno"> 1783</span>        <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">Channels</a>* init_channels_by_srv_req, <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a>&amp;&amp; mdt_from_srv)</div>
<div class="line"><a id="l01784" name="l01784"></a><span class="lineno"> 1784</span>{</div>
<div class="line"><a id="l01785" name="l01785"></a><span class="lineno"> 1785</span>  <span class="keyword">using </span>schema::detail::OpenChannelResult;</div>
<div class="line"><a id="l01786" name="l01786"></a><span class="lineno"> 1786</span>  <span class="keyword">using </span>flow::util::ostream_op_string;</div>
<div class="line"><a id="l01787" name="l01787"></a><span class="lineno"> 1787</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l01788" name="l01788"></a><span class="lineno"> 1788</span> </div>
<div class="line"><a id="l01789" name="l01789"></a><span class="lineno"> 1789</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01790" name="l01790"></a><span class="lineno"> 1790</span> </div>
<div class="line"><a id="l01791" name="l01791"></a><span class="lineno"> 1791</span>  assert((m_state == State::S_CONNECTING)</div>
<div class="line"><a id="l01792" name="l01792"></a><span class="lineno"> 1792</span>         &amp;&amp; <span class="stringliteral">&quot;Once master-channel is up/past log-in there are 2 ways to exit CONNECTING state: 1, &quot;</span></div>
<div class="line"><a id="l01793" name="l01793"></a><span class="lineno"> 1793</span>              <span class="stringliteral">&quot;on_master_channel_init_open_channel(): we are it; 2, on_master_channel_error(), but if that has been &quot;</span></div>
<div class="line"><a id="l01794" name="l01794"></a><span class="lineno"> 1794</span>              <span class="stringliteral">&quot;called already, then we (on_master_channel_init_open_channel()) should not have been.&quot;</span>);</div>
<div class="line"><a id="l01795" name="l01795"></a><span class="lineno"> 1795</span>  assert((!m_conn_on_done_func_or_empty.empty())</div>
<div class="line"><a id="l01796" name="l01796"></a><span class="lineno"> 1796</span>         &amp;&amp; <span class="stringliteral">&quot;m_conn_on_done_func_or_empty can only be emptied upon executing it.&quot;</span>);</div>
<div class="line"><a id="l01797" name="l01797"></a><span class="lineno"> 1797</span> </div>
<div class="line"><a id="l01798" name="l01798"></a><span class="lineno"> 1798</span>  <span class="keyword">const</span> <span class="keyword">auto</span> root = open_channel_msg-&gt;body_root().getOpenChannelToClientReq();</div>
<div class="line"><a id="l01799" name="l01799"></a><span class="lineno"> 1799</span>  <span class="keyword">auto</span>&amp; init_channels = *init_channels_ptr;</div>
<div class="line"><a id="l01800" name="l01800"></a><span class="lineno"> 1800</span> </div>
<div class="line"><a id="l01801" name="l01801"></a><span class="lineno"> 1801</span>  <span class="comment">// Cool! We can open our side of each channel component based on the stuff server prepared and sent to us.</span></div>
<div class="line"><a id="l01802" name="l01802"></a><span class="lineno"> 1802</span> </div>
<div class="line"><a id="l01803" name="l01803"></a><span class="lineno"> 1803</span>  <span class="keyword">auto</span> local_hndl_or_null = open_channel_msg-&gt;native_handle_or_null();</div>
<div class="line"><a id="l01804" name="l01804"></a><span class="lineno"> 1804</span>  <span class="keyword">const</span> <span class="keyword">auto</span> mq_name_c2s_or_none = <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(<span class="keywordtype">string</span>(root.getClientToServerMqAbsNameOrEmpty()));</div>
<div class="line"><a id="l01805" name="l01805"></a><span class="lineno"> 1805</span>  <span class="keyword">const</span> <span class="keyword">auto</span> mq_name_s2c_or_none = <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(<span class="keywordtype">string</span>(root.getServerToClientMqAbsNameOrEmpty()));</div>
<div class="line"><a id="l01806" name="l01806"></a><span class="lineno"> 1806</span> </div>
<div class="line"><a id="l01807" name="l01807"></a><span class="lineno"> 1807</span>  <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code;</div>
<div class="line"><a id="l01808" name="l01808"></a><span class="lineno"> 1808</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a> opened_channel;</div>
<div class="line"><a id="l01809" name="l01809"></a><span class="lineno"> 1809</span>  create_channel_obj(mq_name_c2s_or_none, mq_name_s2c_or_none, std::move(local_hndl_or_null),</div>
<div class="line"><a id="l01810" name="l01810"></a><span class="lineno"> 1810</span>                     &amp;opened_channel, <span class="keyword">false</span>, <span class="comment">// false =&gt; passive.</span></div>
<div class="line"><a id="l01811" name="l01811"></a><span class="lineno"> 1811</span>                     &amp;err_code);</div>
<div class="line"><a id="l01812" name="l01812"></a><span class="lineno"> 1812</span>  <span class="comment">// err_code is either success or failure, and opened_channel is either blank or a PEER-state Channel.</span></div>
<div class="line"><a id="l01813" name="l01813"></a><span class="lineno"> 1813</span> </div>
<div class="line"><a id="l01814" name="l01814"></a><span class="lineno"> 1814</span>  assert((!err_code)</div>
<div class="line"><a id="l01815" name="l01815"></a><span class="lineno"> 1815</span>         &amp;&amp; <span class="stringliteral">&quot;As of this writing the only path to this is inside the MQ-related guts of Channel creation (if &quot;</span></div>
<div class="line"><a id="l01816" name="l01816"></a><span class="lineno"> 1816</span>              <span class="stringliteral">&quot;MQs are even configured), namely because something in Blob_stream_mq_base_impl indicates &quot;</span></div>
<div class="line"><a id="l01817" name="l01817"></a><span class="lineno"> 1817</span>              <span class="stringliteral">&quot;there&#39;d be no more than 1 MQ receiver or 1 MQ sender for a given MQ (c2s or s2c) &quot;</span></div>
<div class="line"><a id="l01818" name="l01818"></a><span class="lineno"> 1818</span>              <span class="stringliteral">&quot;and that is *after* server was able to get through its side of the same thing not to mention &quot;</span></div>
<div class="line"><a id="l01819" name="l01819"></a><span class="lineno"> 1819</span>              <span class="stringliteral">&quot;create the MQs in the first place.  So it is very strange no-man&#39;s-land; we abort.  @todo Reconsider.&quot;</span>);</div>
<div class="line"><a id="l01820" name="l01820"></a><span class="lineno"> 1820</span> </div>
<div class="line"><a id="l01821" name="l01821"></a><span class="lineno"> 1821</span>  <span class="comment">// Great!  opened_channel is ready (in PEER state).  Add it to intermediate container init_channels.</span></div>
<div class="line"><a id="l01822" name="l01822"></a><span class="lineno"> 1822</span>  assert(init_channels.size() &lt; n_init_channels);</div>
<div class="line"><a id="l01823" name="l01823"></a><span class="lineno"> 1823</span>  init_channels.emplace_back(std::move(opened_channel));</div>
<div class="line"><a id="l01824" name="l01824"></a><span class="lineno"> 1824</span> </div>
<div class="line"><a id="l01825" name="l01825"></a><span class="lineno"> 1825</span>  <span class="keywordflow">if</span> (init_channels.size() != n_init_channels)</div>
<div class="line"><a id="l01826" name="l01826"></a><span class="lineno"> 1826</span>  {</div>
<div class="line"><a id="l01827" name="l01827"></a><span class="lineno"> 1827</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Passive init-open-channel: Successful on this side!  &quot;</span></div>
<div class="line"><a id="l01828" name="l01828"></a><span class="lineno"> 1828</span>                   <span class="stringliteral">&quot;Of expected total [&quot;</span> &lt;&lt; n_init_channels &lt;&lt; <span class="stringliteral">&quot;] channels we have set-up &quot;</span></div>
<div class="line"><a id="l01829" name="l01829"></a><span class="lineno"> 1829</span>                   <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; init_channels.size() &lt;&lt; <span class="stringliteral">&quot;]; more shall be coming soon.  &quot;</span></div>
<div class="line"><a id="l01830" name="l01830"></a><span class="lineno"> 1830</span>                   <span class="stringliteral">&quot;We save local peer Channel object [&quot;</span> &lt;&lt; opened_channel &lt;&lt; <span class="stringliteral">&quot;] for now.&quot;</span>);</div>
<div class="line"><a id="l01831" name="l01831"></a><span class="lineno"> 1831</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01832" name="l01832"></a><span class="lineno"> 1832</span>  }</div>
<div class="line"><a id="l01833" name="l01833"></a><span class="lineno"> 1833</span>  <span class="comment">// else if (init_channels has n_init_channels elements)</span></div>
<div class="line"><a id="l01834" name="l01834"></a><span class="lineno"> 1834</span> </div>
<div class="line"><a id="l01835" name="l01835"></a><span class="lineno"> 1835</span>  <span class="comment">/* Don&#39;t forget to set-up the normal open-channel-to-client-request handler now (same as the no-init-channels</span></div>
<div class="line"><a id="l01836" name="l01836"></a><span class="lineno"> 1836</span><span class="comment">   * path in on_master_channel_log_in_rsp() -- which we did not take).  Keeping comments light. */</span></div>
<div class="line"><a id="l01837" name="l01837"></a><span class="lineno"> 1837</span>  <span class="keywordflow">if</span> (!m_master_channel-&gt;undo_expect_msgs(Master_structured_channel::Msg_which_in::OPEN_CHANNEL_TO_CLIENT_REQ))</div>
<div class="line"><a id="l01838" name="l01838"></a><span class="lineno"> 1838</span>  {</div>
<div class="line"><a id="l01839" name="l01839"></a><span class="lineno"> 1839</span>    <span class="comment">// Got hosed very recently (that logged).  on_master_channel_error() will deal with it.</span></div>
<div class="line"><a id="l01840" name="l01840"></a><span class="lineno"> 1840</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01841" name="l01841"></a><span class="lineno"> 1841</span>  }</div>
<div class="line"><a id="l01842" name="l01842"></a><span class="lineno"> 1842</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01843" name="l01843"></a><span class="lineno"> 1843</span> </div>
<div class="line"><a id="l01844" name="l01844"></a><span class="lineno"> 1844</span>  <span class="keywordtype">bool</span> ok = m_master_channel-&gt;expect_msgs(Master_structured_channel::Msg_which_in::OPEN_CHANNEL_TO_CLIENT_REQ,</div>
<div class="line"><a id="l01845" name="l01845"></a><span class="lineno"> 1845</span>                                         [<span class="keyword">this</span>](<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; open_channel_req)</div>
<div class="line"><a id="l01846" name="l01846"></a><span class="lineno"> 1846</span>  {</div>
<div class="line"><a id="l01847" name="l01847"></a><span class="lineno"> 1847</span>    m_async_worker.post([<span class="keyword">this</span>, open_channel_req = std::move(open_channel_req)]() <span class="keyword">mutable</span></div>
<div class="line"><a id="l01848" name="l01848"></a><span class="lineno"> 1848</span>    {</div>
<div class="line"><a id="l01849" name="l01849"></a><span class="lineno"> 1849</span>      on_master_channel_open_channel_req(std::move(open_channel_req));</div>
<div class="line"><a id="l01850" name="l01850"></a><span class="lineno"> 1850</span>    });</div>
<div class="line"><a id="l01851" name="l01851"></a><span class="lineno"> 1851</span>  });</div>
<div class="line"><a id="l01852" name="l01852"></a><span class="lineno"> 1852</span>  <span class="keywordflow">if</span> (!ok)</div>
<div class="line"><a id="l01853" name="l01853"></a><span class="lineno"> 1853</span>  {</div>
<div class="line"><a id="l01854" name="l01854"></a><span class="lineno"> 1854</span>    <span class="keywordflow">return</span>; <span class="comment">// Again (see undo_expect_msgs() path above).</span></div>
<div class="line"><a id="l01855" name="l01855"></a><span class="lineno"> 1855</span>  }</div>
<div class="line"><a id="l01856" name="l01856"></a><span class="lineno"> 1856</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01857" name="l01857"></a><span class="lineno"> 1857</span> </div>
<div class="line"><a id="l01858" name="l01858"></a><span class="lineno"> 1858</span>  <span class="comment">// As planned, respond to the last one.</span></div>
<div class="line"><a id="l01859" name="l01859"></a><span class="lineno"> 1859</span>  <span class="keyword">auto</span> open_channel_rsp = m_master_channel-&gt;create_msg();</div>
<div class="line"><a id="l01860" name="l01860"></a><span class="lineno"> 1860</span>  open_channel_rsp.body_root()-&gt;initOpenChannelToClientRsp().setOpenChannelResult(OpenChannelResult::ACCEPTED);</div>
<div class="line"><a id="l01861" name="l01861"></a><span class="lineno"> 1861</span>  <span class="keywordflow">if</span> (!m_master_channel-&gt;send(open_channel_rsp, open_channel_msg.get(), &amp;err_code))</div>
<div class="line"><a id="l01862" name="l01862"></a><span class="lineno"> 1862</span>  {</div>
<div class="line"><a id="l01863" name="l01863"></a><span class="lineno"> 1863</span>    <span class="keywordflow">return</span>; <span class="comment">// Again (see undo_expect_msgs() path above).</span></div>
<div class="line"><a id="l01864" name="l01864"></a><span class="lineno"> 1864</span>  }</div>
<div class="line"><a id="l01865" name="l01865"></a><span class="lineno"> 1865</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01866" name="l01866"></a><span class="lineno"> 1866</span>  <span class="keywordflow">if</span> (err_code)</div>
<div class="line"><a id="l01867" name="l01867"></a><span class="lineno"> 1867</span>  {</div>
<div class="line"><a id="l01868" name="l01868"></a><span class="lineno"> 1868</span>    <span class="comment">// Sigh.  send() emitted error: we must handle it.  Go to NULL state as, e.g., if log-in request send() fails.</span></div>
<div class="line"><a id="l01869" name="l01869"></a><span class="lineno"> 1869</span> </div>
<div class="line"><a id="l01870" name="l01870"></a><span class="lineno"> 1870</span>    m_state = State::S_NULL;</div>
<div class="line"><a id="l01871" name="l01871"></a><span class="lineno"> 1871</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Master channel Native_socket_stream &quot;</span></div>
<div class="line"><a id="l01872" name="l01872"></a><span class="lineno"> 1872</span>                   <span class="stringliteral">&quot;async-connect succeeded, and the log-in request sending &quot;</span></div>
<div class="line"><a id="l01873" name="l01873"></a><span class="lineno"> 1873</span>                   <span class="stringliteral">&quot;succeeded, and the log-in response was received OK, and then channel-opening &quot;</span></div>
<div class="line"><a id="l01874" name="l01874"></a><span class="lineno"> 1874</span>                   <span class="stringliteral">&quot;succeeded, but the send of the OK response to the last &quot;</span></div>
<div class="line"><a id="l01875" name="l01875"></a><span class="lineno"> 1875</span>                   <span class="stringliteral">&quot;channel info notification failed (see above for details).  Executing handler.&quot;</span>);</div>
<div class="line"><a id="l01876" name="l01876"></a><span class="lineno"> 1876</span>    invoke_conn_on_done_func(err_code);</div>
<div class="line"><a id="l01877" name="l01877"></a><span class="lineno"> 1877</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01878" name="l01878"></a><span class="lineno"> 1878</span>  } <span class="comment">// if (err_code)</span></div>
<div class="line"><a id="l01879" name="l01879"></a><span class="lineno"> 1879</span> </div>
<div class="line"><a id="l01880" name="l01880"></a><span class="lineno"> 1880</span>  <span class="comment">// Whew!  Nothing can go wrong now; we shall go to PEER state.  Emit results via out-args.</span></div>
<div class="line"><a id="l01881" name="l01881"></a><span class="lineno"> 1881</span> </div>
<div class="line"><a id="l01882" name="l01882"></a><span class="lineno"> 1882</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Passive init-open-channel: Successful on this side!  &quot;</span></div>
<div class="line"><a id="l01883" name="l01883"></a><span class="lineno"> 1883</span>                <span class="stringliteral">&quot;We now have the expected total [&quot;</span> &lt;&lt; n_init_channels &lt;&lt; <span class="stringliteral">&quot;] channels.  Shall emit them &quot;</span></div>
<div class="line"><a id="l01884" name="l01884"></a><span class="lineno"> 1884</span>                <span class="stringliteral">&quot;(see next log messages) and metadata.  Will go to PEER state and report to user via &quot;</span></div>
<div class="line"><a id="l01885" name="l01885"></a><span class="lineno"> 1885</span>                <span class="stringliteral">&quot;on-async-connect handler.&quot;</span>);</div>
<div class="line"><a id="l01886" name="l01886"></a><span class="lineno"> 1886</span>  <span class="keywordtype">size_t</span> idx = 0;</div>
<div class="line"><a id="l01887" name="l01887"></a><span class="lineno"> 1887</span>  <span class="keywordflow">if</span> (init_channels_by_cli_req_pre_sized)</div>
<div class="line"><a id="l01888" name="l01888"></a><span class="lineno"> 1888</span>  {</div>
<div class="line"><a id="l01889" name="l01889"></a><span class="lineno"> 1889</span>    <span class="keywordflow">for</span> (<span class="keyword">auto</span>&amp; init_channel_ref : *init_channels_by_cli_req_pre_sized)</div>
<div class="line"><a id="l01890" name="l01890"></a><span class="lineno"> 1890</span>    {</div>
<div class="line"><a id="l01891" name="l01891"></a><span class="lineno"> 1891</span>      init_channel_ref = std::move(init_channels[idx]);</div>
<div class="line"><a id="l01892" name="l01892"></a><span class="lineno"> 1892</span>      FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Emitting init-channel (cli-requested): &quot;</span></div>
<div class="line"><a id="l01893" name="l01893"></a><span class="lineno"> 1893</span>                    <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; init_channel_ref &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01894" name="l01894"></a><span class="lineno"> 1894</span>      ++idx;</div>
<div class="line"><a id="l01895" name="l01895"></a><span class="lineno"> 1895</span>    }</div>
<div class="line"><a id="l01896" name="l01896"></a><span class="lineno"> 1896</span>  }</div>
<div class="line"><a id="l01897" name="l01897"></a><span class="lineno"> 1897</span>  <span class="keywordflow">if</span> (init_channels_by_srv_req)</div>
<div class="line"><a id="l01898" name="l01898"></a><span class="lineno"> 1898</span>  {</div>
<div class="line"><a id="l01899" name="l01899"></a><span class="lineno"> 1899</span>    <span class="keyword">auto</span>&amp; init_channels_by_srv_req_ref = *init_channels_by_srv_req;</div>
<div class="line"><a id="l01900" name="l01900"></a><span class="lineno"> 1900</span>    init_channels_by_srv_req_ref.clear();</div>
<div class="line"><a id="l01901" name="l01901"></a><span class="lineno"> 1901</span>    init_channels_by_srv_req_ref.reserve(n_init_channels - idx);</div>
<div class="line"><a id="l01902" name="l01902"></a><span class="lineno"> 1902</span>    <span class="keywordflow">for</span> (; idx != n_init_channels; ++idx)</div>
<div class="line"><a id="l01903" name="l01903"></a><span class="lineno"> 1903</span>    {</div>
<div class="line"><a id="l01904" name="l01904"></a><span class="lineno"> 1904</span>      init_channels_by_srv_req_ref.emplace_back(std::move(init_channels[idx]));</div>
<div class="line"><a id="l01905" name="l01905"></a><span class="lineno"> 1905</span>      FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Emitting init-channel (srv-requested): &quot;</span></div>
<div class="line"><a id="l01906" name="l01906"></a><span class="lineno"> 1906</span>                    <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; init_channels_by_srv_req_ref.back() &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01907" name="l01907"></a><span class="lineno"> 1907</span>    }</div>
<div class="line"><a id="l01908" name="l01908"></a><span class="lineno"> 1908</span>  }</div>
<div class="line"><a id="l01909" name="l01909"></a><span class="lineno"> 1909</span>  assert(idx == n_init_channels);</div>
<div class="line"><a id="l01910" name="l01910"></a><span class="lineno"> 1910</span>  <span class="comment">// OK: Channel out-args all the way from async_connect() have been set.  Now same for mdt; and invoke handler.</span></div>
<div class="line"><a id="l01911" name="l01911"></a><span class="lineno"> 1911</span> </div>
<div class="line"><a id="l01912" name="l01912"></a><span class="lineno"> 1912</span>  assert((<span class="keywordtype">bool</span>(mdt_from_srv_or_null) == <span class="keywordtype">bool</span>(mdt_from_srv)) &amp;&amp; <span class="stringliteral">&quot;Some logic in log-in handler must be broken.&quot;</span>);</div>
<div class="line"><a id="l01913" name="l01913"></a><span class="lineno"> 1913</span>  <span class="keywordflow">if</span> (mdt_from_srv_or_null)</div>
<div class="line"><a id="l01914" name="l01914"></a><span class="lineno"> 1914</span>  {</div>
<div class="line"><a id="l01915" name="l01915"></a><span class="lineno"> 1915</span>    *mdt_from_srv_or_null = std::move(mdt_from_srv);</div>
<div class="line"><a id="l01916" name="l01916"></a><span class="lineno"> 1916</span>  }</div>
<div class="line"><a id="l01917" name="l01917"></a><span class="lineno"> 1917</span> </div>
<div class="line"><a id="l01918" name="l01918"></a><span class="lineno"> 1918</span>  <span class="comment">// Halle-freakin&#39;-lujah!</span></div>
<div class="line"><a id="l01919" name="l01919"></a><span class="lineno"> 1919</span> </div>
<div class="line"><a id="l01920" name="l01920"></a><span class="lineno"> 1920</span>  m_state = State::S_PEER;</div>
<div class="line"><a id="l01921" name="l01921"></a><span class="lineno"> 1921</span> </div>
<div class="line"><a id="l01922" name="l01922"></a><span class="lineno"> 1922</span>  FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-connect request: Master channel Native_socket_stream &quot;</span></div>
<div class="line"><a id="l01923" name="l01923"></a><span class="lineno"> 1923</span>                 <span class="stringliteral">&quot;async-connect succeded, and the log-in within the resulting channel succeeded, and the init-channel &quot;</span></div>
<div class="line"><a id="l01924" name="l01924"></a><span class="lineno"> 1924</span>                 <span class="stringliteral">&quot;opening succeeded.  Executing handler.&quot;</span>);</div>
<div class="line"><a id="l01925" name="l01925"></a><span class="lineno"> 1925</span>  invoke_conn_on_done_func(err_code);</div>
<div class="line"><a id="l01926" name="l01926"></a><span class="lineno"> 1926</span> </div>
<div class="line"><a id="l01927" name="l01927"></a><span class="lineno"> 1927</span>  <span class="comment">// That&#39;s it.  They can proceed with session work.  (Unless subclass just did a cancel_peer_state_to_*().)</span></div>
<div class="line"><a id="l01928" name="l01928"></a><span class="lineno"> 1928</span> </div>
<div class="line"><a id="l01929" name="l01929"></a><span class="lineno"> 1929</span>  <span class="comment">// Same stuff as in the no-init-channels path, where state becomes PEER.  *Please* see key comments there.</span></div>
<div class="line"><a id="l01930" name="l01930"></a><span class="lineno"> 1930</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_GRACEFUL_FINISH_REQUIRED)</div>
<div class="line"><a id="l01931" name="l01931"></a><span class="lineno"> 1931</span>  {</div>
<div class="line"><a id="l01932" name="l01932"></a><span class="lineno"> 1932</span>    assert((m_state != State::S_PEER) &amp;&amp;</div>
<div class="line"><a id="l01933" name="l01933"></a><span class="lineno"> 1933</span>           <span class="stringliteral">&quot;In practice only SHM-jemalloc should use GRACEFUL_FINISH_REQUIRED=true, and that guy should have &quot;</span></div>
<div class="line"><a id="l01934" name="l01934"></a><span class="lineno"> 1934</span>             <span class="stringliteral">&quot;canceled PEER state via cancel_peer_state_to_connecting() at best; see above comment and to-do.&quot;</span>);</div>
<div class="line"><a id="l01935" name="l01935"></a><span class="lineno"> 1935</span>    <span class="comment">// Commented out: m_graceful_finisher.emplace(get_logger(), this, &amp;m_async_worker, m_master_channel.get());</span></div>
<div class="line"><a id="l01936" name="l01936"></a><span class="lineno"> 1936</span>  }</div>
<div class="line"><a id="l01937" name="l01937"></a><span class="lineno"> 1937</span>} <span class="comment">// Client_session_impl::on_master_channel_init_open_channel()</span></div>
<div class="line"><a id="l01938" name="l01938"></a><span class="lineno"> 1938</span> </div>
<div class="line"><a id="l01939" name="l01939"></a><span class="lineno"> 1939</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01940" name="l01940"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a428ae010a09aae1bac509e87fd927152"> 1940</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::invoke_conn_on_done_func(<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; err_code)</div>
<div class="line"><a id="l01941" name="l01941"></a><span class="lineno"> 1941</span>{</div>
<div class="line"><a id="l01942" name="l01942"></a><span class="lineno"> 1942</span>  <span class="comment">/* As promised we&#39;ll .clear() the member *before* invoking it; so that the handler itself -- as of this writing</span></div>
<div class="line"><a id="l01943" name="l01943"></a><span class="lineno"> 1943</span><span class="comment">   * only in the case of a sub-class (e.g., an ipc::session::shm:: thing) async_connect() calling our own and</span></div>
<div class="line"><a id="l01944" name="l01944"></a><span class="lineno"> 1944</span><span class="comment">   * substituting its own wrapper around the user&#39;s actual handler -- can un-.clear() it for its own nefarious</span></div>
<div class="line"><a id="l01945" name="l01945"></a><span class="lineno"> 1945</span><span class="comment">   * purposes. */</span></div>
<div class="line"><a id="l01946" name="l01946"></a><span class="lineno"> 1946</span> </div>
<div class="line"><a id="l01947" name="l01947"></a><span class="lineno"> 1947</span>  <span class="keyword">auto</span> func = std::move(m_conn_on_done_func_or_empty);</div>
<div class="line"><a id="l01948" name="l01948"></a><span class="lineno"> 1948</span>  m_conn_on_done_func_or_empty.clear();</div>
<div class="line"><a id="l01949" name="l01949"></a><span class="lineno"> 1949</span> </div>
<div class="line"><a id="l01950" name="l01950"></a><span class="lineno"> 1950</span>  func(err_code);</div>
<div class="line"><a id="l01951" name="l01951"></a><span class="lineno"> 1951</span>  FLOW_LOG_TRACE(<span class="stringliteral">&quot;Handler finished.&quot;</span>);</div>
<div class="line"><a id="l01952" name="l01952"></a><span class="lineno"> 1952</span>}</div>
<div class="line"><a id="l01953" name="l01953"></a><span class="lineno"> 1953</span> </div>
<div class="line"><a id="l01954" name="l01954"></a><span class="lineno"> 1954</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l01955" name="l01955"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a417e9c40eefdfb4622f84275795640c4"> 1955</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::on_master_channel_error</div>
<div class="line"><a id="l01956" name="l01956"></a><span class="lineno"> 1956</span>       (<span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a6a1cb9c344c312b4eff5c360d7114e2c">Master_structured_channel_observer</a>&amp; master_channel_observer,</div>
<div class="line"><a id="l01957" name="l01957"></a><span class="lineno"> 1957</span>        <span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; err_code)</div>
<div class="line"><a id="l01958" name="l01958"></a><span class="lineno"> 1958</span>{</div>
<div class="line"><a id="l01959" name="l01959"></a><span class="lineno"> 1959</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01960" name="l01960"></a><span class="lineno"> 1960</span> </div>
<div class="line"><a id="l01961" name="l01961"></a><span class="lineno"> 1961</span>  <span class="keyword">auto</span> master_channel = master_channel_observer.lock();</div>
<div class="line"><a id="l01962" name="l01962"></a><span class="lineno"> 1962</span>  <span class="keywordflow">if</span> (!master_channel)</div>
<div class="line"><a id="l01963" name="l01963"></a><span class="lineno"> 1963</span>  {</div>
<div class="line"><a id="l01964" name="l01964"></a><span class="lineno"> 1964</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session master channel reported error; but the source &quot;</span></div>
<div class="line"><a id="l01965" name="l01965"></a><span class="lineno"> 1965</span>                   <span class="stringliteral">&quot;master channel has since been destroyed; so presumably the log-in response was received &quot;</span></div>
<div class="line"><a id="l01966" name="l01966"></a><span class="lineno"> 1966</span>                   <span class="stringliteral">&quot;from remote server, and it was invalid, so the channel was destroyed by our log-in response &quot;</span></div>
<div class="line"><a id="l01967" name="l01967"></a><span class="lineno"> 1967</span>                   <span class="stringliteral">&quot;handler; but coincidentally before that destruction could occur an incoming-direction &quot;</span></div>
<div class="line"><a id="l01968" name="l01968"></a><span class="lineno"> 1968</span>                   <span class="stringliteral">&quot;channel error occurred.  The error does not matter anymore.  Ignoring.&quot;</span>);</div>
<div class="line"><a id="l01969" name="l01969"></a><span class="lineno"> 1969</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01970" name="l01970"></a><span class="lineno"> 1970</span>  }</div>
<div class="line"><a id="l01971" name="l01971"></a><span class="lineno"> 1971</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01972" name="l01972"></a><span class="lineno"> 1972</span> </div>
<div class="line"><a id="l01973" name="l01973"></a><span class="lineno"> 1973</span>  assert((master_channel == m_master_channel)</div>
<div class="line"><a id="l01974" name="l01974"></a><span class="lineno"> 1974</span>         &amp;&amp; <span class="stringliteral">&quot;As of this writing m_master_channel is the only referrer to the underlying master channel; &quot;</span></div>
<div class="line"><a id="l01975" name="l01975"></a><span class="lineno"> 1975</span>              <span class="stringliteral">&quot;hence if the observer still refers to *something* it must refer to m_master_channel.&quot;</span>);</div>
<div class="line"><a id="l01976" name="l01976"></a><span class="lineno"> 1976</span>  master_channel.reset();</div>
<div class="line"><a id="l01977" name="l01977"></a><span class="lineno"> 1977</span>  <span class="comment">// From this point on just rely on m_master_channel.  (It is only touched in thread W and needs no lock.)</span></div>
<div class="line"><a id="l01978" name="l01978"></a><span class="lineno"> 1978</span> </div>
<div class="line"><a id="l01979" name="l01979"></a><span class="lineno"> 1979</span>  assert((m_state != State::S_NULL) &amp;&amp; <span class="stringliteral">&quot;State cannot change to NULL while keeping m_master_channel alive.&quot;</span>);</div>
<div class="line"><a id="l01980" name="l01980"></a><span class="lineno"> 1980</span> </div>
<div class="line"><a id="l01981" name="l01981"></a><span class="lineno"> 1981</span>  <span class="keywordflow">if</span> (m_state == State::S_CONNECTING)</div>
<div class="line"><a id="l01982" name="l01982"></a><span class="lineno"> 1982</span>  {</div>
<div class="line"><a id="l01983" name="l01983"></a><span class="lineno"> 1983</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Log-in: Session master channel reported error &quot;</span></div>
<div class="line"><a id="l01984" name="l01984"></a><span class="lineno"> 1984</span>                     <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code.message() &lt;&lt; <span class="stringliteral">&quot;].  Will go back to NULL &quot;</span></div>
<div class="line"><a id="l01985" name="l01985"></a><span class="lineno"> 1985</span>                     <span class="stringliteral">&quot;state and report to user via on-async-connect handler.&quot;</span>);</div>
<div class="line"><a id="l01986" name="l01986"></a><span class="lineno"> 1986</span> </div>
<div class="line"><a id="l01987" name="l01987"></a><span class="lineno"> 1987</span>    <span class="comment">/* Channel incoming-direction error while awaiting log-in response or init-channel-open(s) or even earlier,</span></div>
<div class="line"><a id="l01988" name="l01988"></a><span class="lineno"> 1988</span><span class="comment">     * so as far as they&#39;re concerned, it&#39;s no different from the async-connect failing.  Back</span></div>
<div class="line"><a id="l01989" name="l01989"></a><span class="lineno"> 1989</span><span class="comment">     * to the drawing board; and while at the drawing board the master channel is null. */</span></div>
<div class="line"><a id="l01990" name="l01990"></a><span class="lineno"> 1990</span>    m_master_channel.reset();</div>
<div class="line"><a id="l01991" name="l01991"></a><span class="lineno"> 1991</span> </div>
<div class="line"><a id="l01992" name="l01992"></a><span class="lineno"> 1992</span>    assert((!m_conn_on_done_func_or_empty.empty())</div>
<div class="line"><a id="l01993" name="l01993"></a><span class="lineno"> 1993</span>           &amp;&amp; <span class="stringliteral">&quot;m_conn_on_done_func_or_empty can only be emptied upon executing it.&quot;</span>);</div>
<div class="line"><a id="l01994" name="l01994"></a><span class="lineno"> 1994</span> </div>
<div class="line"><a id="l01995" name="l01995"></a><span class="lineno"> 1995</span>    m_state = State::S_NULL;</div>
<div class="line"><a id="l01996" name="l01996"></a><span class="lineno"> 1996</span> </div>
<div class="line"><a id="l01997" name="l01997"></a><span class="lineno"> 1997</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Executing on-connect handler.&quot;</span>);</div>
<div class="line"><a id="l01998" name="l01998"></a><span class="lineno"> 1998</span>    invoke_conn_on_done_func(err_code);</div>
<div class="line"><a id="l01999" name="l01999"></a><span class="lineno"> 1999</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02000" name="l02000"></a><span class="lineno"> 2000</span>  } <span class="comment">// if (m_state == State::S_CONNECTING)</span></div>
<div class="line"><a id="l02001" name="l02001"></a><span class="lineno"> 2001</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02002" name="l02002"></a><span class="lineno"> 2002</span> </div>
<div class="line"><a id="l02003" name="l02003"></a><span class="lineno"> 2003</span>  assert(m_state == State::S_PEER);</div>
<div class="line"><a id="l02004" name="l02004"></a><span class="lineno"> 2004</span>  <span class="comment">/* Session master channel reported channel-hosing incoming-direction error.  Emit it to user if and only if</span></div>
<div class="line"><a id="l02005" name="l02005"></a><span class="lineno"> 2005</span><span class="comment">   * we haven&#39;t already emitted some error.  If we have, it shouldn&#39;t have come from either</span></div>
<div class="line"><a id="l02006" name="l02006"></a><span class="lineno"> 2006</span><span class="comment">   * m_master_channel-&gt;send()/etc. (synchronously) or a previous on_master_channel_error(): struc::Channel promises</span></div>
<div class="line"><a id="l02007" name="l02007"></a><span class="lineno"> 2007</span><span class="comment">   * to emit any channel-hosing error at most once, through exactly one of those mechanisms.  It is still</span></div>
<div class="line"><a id="l02008" name="l02008"></a><span class="lineno"> 2008</span><span class="comment">   * possible, though: There are sources of error/Error_codes emitted in *this Client_session that don&#39;t come</span></div>
<div class="line"><a id="l02009" name="l02009"></a><span class="lineno"> 2009</span><span class="comment">   * from m_master_channel but our own logic.  (As of this writing, I believe, that was only actually before PEER</span></div>
<div class="line"><a id="l02010" name="l02010"></a><span class="lineno"> 2010</span><span class="comment">   * state; but that could easily change as we maintain the code.) */</span></div>
<div class="line"><a id="l02011" name="l02011"></a><span class="lineno"> 2011</span>  <span class="keywordflow">if</span> (!Base::hosed())</div>
<div class="line"><a id="l02012" name="l02012"></a><span class="lineno"> 2012</span>  {</div>
<div class="line"><a id="l02013" name="l02013"></a><span class="lineno"> 2013</span>    Base::hose(err_code);</div>
<div class="line"><a id="l02014" name="l02014"></a><span class="lineno"> 2014</span>  }</div>
<div class="line"><a id="l02015" name="l02015"></a><span class="lineno"> 2015</span> </div>
<div class="line"><a id="l02016" name="l02016"></a><span class="lineno"> 2016</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_GRACEFUL_FINISH_REQUIRED)</div>
<div class="line"><a id="l02017" name="l02017"></a><span class="lineno"> 2017</span>  {</div>
<div class="line"><a id="l02018" name="l02018"></a><span class="lineno"> 2018</span>    m_graceful_finisher-&gt;on_master_channel_hosed();</div>
<div class="line"><a id="l02019" name="l02019"></a><span class="lineno"> 2019</span>  }</div>
<div class="line"><a id="l02020" name="l02020"></a><span class="lineno"> 2020</span>} <span class="comment">// Client_session_impl::on_master_channel_error()</span></div>
<div class="line"><a id="l02021" name="l02021"></a><span class="lineno"> 2021</span> </div>
<div class="line"><a id="l02022" name="l02022"></a><span class="lineno"> 2022</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02023" name="l02023"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#aad9a5e95ffde170a6483b74f397d9169"> 2023</a></span><span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc_1_1session.html#ade2b302f1a3623e8adc9694568d94d2c">Session_token</a>&amp; CLASS_CLI_SESSION_IMPL::session_token()<span class="keyword"> const</span></div>
<div class="line"><a id="l02024" name="l02024"></a><span class="lineno"> 2024</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02025" name="l02025"></a><span class="lineno"> 2025</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l02026" name="l02026"></a><span class="lineno"> 2026</span> </div>
<div class="line"><a id="l02027" name="l02027"></a><span class="lineno"> 2027</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l02028" name="l02028"></a><span class="lineno"> 2028</span> </div>
<div class="line"><a id="l02029" name="l02029"></a><span class="lineno"> 2029</span>  <span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc_1_1session.html#ade2b302f1a3623e8adc9694568d94d2c">Session_token</a>* result;</div>
<div class="line"><a id="l02030" name="l02030"></a><span class="lineno"> 2030</span> </div>
<div class="line"><a id="l02031" name="l02031"></a><span class="lineno"> 2031</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l02032" name="l02032"></a><span class="lineno"> 2032</span>  {</div>
<div class="line"><a id="l02033" name="l02033"></a><span class="lineno"> 2033</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l02034" name="l02034"></a><span class="lineno"> 2034</span> </div>
<div class="line"><a id="l02035" name="l02035"></a><span class="lineno"> 2035</span>    <span class="keywordflow">if</span> (m_state != State::S_PEER)</div>
<div class="line"><a id="l02036" name="l02036"></a><span class="lineno"> 2036</span>    {</div>
<div class="line"><a id="l02037" name="l02037"></a><span class="lineno"> 2037</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-token accessor: Invoked before PEER state. &quot;</span></div>
<div class="line"><a id="l02038" name="l02038"></a><span class="lineno"> 2038</span>                       <span class="stringliteral">&quot;Returning null.&quot;</span>);</div>
<div class="line"><a id="l02039" name="l02039"></a><span class="lineno"> 2039</span>      result = &amp;(<a class="code hl_variable" href="namespaceipc_1_1transport_1_1struc.html#ad556d20a2aa2d52b83c7afb73951d47d">transport::struc::NULL_SESSION_TOKEN</a>);</div>
<div class="line"><a id="l02040" name="l02040"></a><span class="lineno"> 2040</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02041" name="l02041"></a><span class="lineno"> 2041</span>    }</div>
<div class="line"><a id="l02042" name="l02042"></a><span class="lineno"> 2042</span>    <span class="comment">// else if (m_state == State::S_PEER):</span></div>
<div class="line"><a id="l02043" name="l02043"></a><span class="lineno"> 2043</span> </div>
<div class="line"><a id="l02044" name="l02044"></a><span class="lineno"> 2044</span>    <span class="keywordflow">if</span> (Base::hosed())</div>
<div class="line"><a id="l02045" name="l02045"></a><span class="lineno"> 2045</span>    {</div>
<div class="line"><a id="l02046" name="l02046"></a><span class="lineno"> 2046</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-token accessor: Core executing after session &quot;</span></div>
<div class="line"><a id="l02047" name="l02047"></a><span class="lineno"> 2047</span>                       <span class="stringliteral">&quot;hosed.  Ignoring.&quot;</span>);</div>
<div class="line"><a id="l02048" name="l02048"></a><span class="lineno"> 2048</span>      result = &amp;(<a class="code hl_variable" href="namespaceipc_1_1transport_1_1struc.html#ad556d20a2aa2d52b83c7afb73951d47d">transport::struc::NULL_SESSION_TOKEN</a>);</div>
<div class="line"><a id="l02049" name="l02049"></a><span class="lineno"> 2049</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02050" name="l02050"></a><span class="lineno"> 2050</span>    }</div>
<div class="line"><a id="l02051" name="l02051"></a><span class="lineno"> 2051</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l02052" name="l02052"></a><span class="lineno"> 2052</span> </div>
<div class="line"><a id="l02053" name="l02053"></a><span class="lineno"> 2053</span>    assert(m_master_channel);</div>
<div class="line"><a id="l02054" name="l02054"></a><span class="lineno"> 2054</span>    result = &amp;(m_master_channel-&gt;session_token());</div>
<div class="line"><a id="l02055" name="l02055"></a><span class="lineno"> 2055</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION);</div>
<div class="line"><a id="l02056" name="l02056"></a><span class="lineno"> 2056</span> </div>
<div class="line"><a id="l02057" name="l02057"></a><span class="lineno"> 2057</span>  <span class="keywordflow">return</span> *result;</div>
<div class="line"><a id="l02058" name="l02058"></a><span class="lineno"> 2058</span>} <span class="comment">// Client_session_impl::session_token()</span></div>
<div class="line"><a id="l02059" name="l02059"></a><span class="lineno"> 2059</span> </div>
<div class="line"><a id="l02060" name="l02060"></a><span class="lineno"> 2060</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02061" name="l02061"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a7ecad909e1013271ff365437f2fdae85"> 2061</a></span><span class="keyword">typename</span> CLASS_CLI_SESSION_IMPL::Mdt_builder_ptr CLASS_CLI_SESSION_IMPL::mdt_builder()<span class="keyword"> const</span></div>
<div class="line"><a id="l02062" name="l02062"></a><span class="lineno"> 2062</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02063" name="l02063"></a><span class="lineno"> 2063</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l02064" name="l02064"></a><span class="lineno"> 2064</span> </div>
<div class="line"><a id="l02065" name="l02065"></a><span class="lineno"> 2065</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l02066" name="l02066"></a><span class="lineno"> 2066</span> </div>
<div class="line"><a id="l02067" name="l02067"></a><span class="lineno"> 2067</span>  <span class="keyword">typename</span> Master_structured_channel::Msg_out req_msg;</div>
<div class="line"><a id="l02068" name="l02068"></a><span class="lineno"> 2068</span>  <span class="keywordtype">bool</span> connect_else_open;</div>
<div class="line"><a id="l02069" name="l02069"></a><span class="lineno"> 2069</span>  <span class="keywordtype">bool</span> ok = <span class="keyword">false</span>;</div>
<div class="line"><a id="l02070" name="l02070"></a><span class="lineno"> 2070</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l02071" name="l02071"></a><span class="lineno"> 2071</span>  {</div>
<div class="line"><a id="l02072" name="l02072"></a><span class="lineno"> 2072</span>    <span class="comment">// We are in thread W: have to be for both m_state and m_master_channel access.</span></div>
<div class="line"><a id="l02073" name="l02073"></a><span class="lineno"> 2073</span> </div>
<div class="line"><a id="l02074" name="l02074"></a><span class="lineno"> 2074</span>    <span class="keywordflow">if</span> (m_state == State::S_CONNECTING)</div>
<div class="line"><a id="l02075" name="l02075"></a><span class="lineno"> 2075</span>    {</div>
<div class="line"><a id="l02076" name="l02076"></a><span class="lineno"> 2076</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open metadata request: Invoked while CONNECTING; &quot;</span></div>
<div class="line"><a id="l02077" name="l02077"></a><span class="lineno"> 2077</span>                       <span class="stringliteral">&quot;must be in NULL state before async_connect() or in PEER state before open_channel().  &quot;</span></div>
<div class="line"><a id="l02078" name="l02078"></a><span class="lineno"> 2078</span>                       <span class="stringliteral">&quot;Ignoring.&quot;</span>);</div>
<div class="line"><a id="l02079" name="l02079"></a><span class="lineno"> 2079</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02080" name="l02080"></a><span class="lineno"> 2080</span>    }</div>
<div class="line"><a id="l02081" name="l02081"></a><span class="lineno"> 2081</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l02082" name="l02082"></a><span class="lineno"> 2082</span>    connect_else_open = m_state == State::S_NULL;</div>
<div class="line"><a id="l02083" name="l02083"></a><span class="lineno"> 2083</span> </div>
<div class="line"><a id="l02084" name="l02084"></a><span class="lineno"> 2084</span>    <span class="comment">/* OK, so we really want something like m_master_channel-&gt;create_msg() (then we&#39;ll fill it out and return</span></div>
<div class="line"><a id="l02085" name="l02085"></a><span class="lineno"> 2085</span><span class="comment">     * alias-pointer into its metadata sub-builder).  Before CONNECTING, though, there is no m_master_channel</span></div>
<div class="line"><a id="l02086" name="l02086"></a><span class="lineno"> 2086</span><span class="comment">     * yet.  That&#39;s really a convenience, though; create_msg() (per its docs) merely supplies the little</span></div>
<div class="line"><a id="l02087" name="l02087"></a><span class="lineno"> 2087</span><span class="comment">     * Builder_config stored in m_master_channel.  We can make one without the channel easily enough.</span></div>
<div class="line"><a id="l02088" name="l02088"></a><span class="lineno"> 2088</span><span class="comment">     * Granted it&#39;s slightly annoying (and some logic from struc::Channel is repeated; @todo improve) but w/e. */</span></div>
<div class="line"><a id="l02089" name="l02089"></a><span class="lineno"> 2089</span>    <span class="keyword">const</span> <span class="keyword">typename</span> Master_structured_channel::Builder_config</div>
<div class="line"><a id="l02090" name="l02090"></a><span class="lineno"> 2090</span>      builder_config{ get_logger(), <a class="code hl_variable" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html#a00624e2fc3757012d13e3dc0feb26a21">transport::sync_io::Native_socket_stream::S_MAX_META_BLOB_LENGTH</a>, 0, 0 };</div>
<div class="line"><a id="l02091" name="l02091"></a><span class="lineno"> 2091</span> </div>
<div class="line"><a id="l02092" name="l02092"></a><span class="lineno"> 2092</span>    req_msg = <span class="keyword">decltype</span>(req_msg)(builder_config); <span class="comment">// Construct it.  We&#39;ve done same thing as -&gt;create_msg().</span></div>
<div class="line"><a id="l02093" name="l02093"></a><span class="lineno"> 2093</span>    ok = <span class="keyword">true</span>;</div>
<div class="line"><a id="l02094" name="l02094"></a><span class="lineno"> 2094</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION);</div>
<div class="line"><a id="l02095" name="l02095"></a><span class="lineno"> 2095</span> </div>
<div class="line"><a id="l02096" name="l02096"></a><span class="lineno"> 2096</span>  <span class="comment">// The rest we can do back in thread U again.</span></div>
<div class="line"><a id="l02097" name="l02097"></a><span class="lineno"> 2097</span> </div>
<div class="line"><a id="l02098" name="l02098"></a><span class="lineno"> 2098</span>  <span class="keywordflow">if</span> (!ok)</div>
<div class="line"><a id="l02099" name="l02099"></a><span class="lineno"> 2099</span>  {</div>
<div class="line"><a id="l02100" name="l02100"></a><span class="lineno"> 2100</span>    <span class="comment">// As advertised: Previous error (reported via on-error handler) =&gt; return null.</span></div>
<div class="line"><a id="l02101" name="l02101"></a><span class="lineno"> 2101</span>    <span class="keywordflow">return</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a9d93e6080abf3b0827b97e084f5e8356">Mdt_builder_ptr</a>();</div>
<div class="line"><a id="l02102" name="l02102"></a><span class="lineno"> 2102</span>  }</div>
<div class="line"><a id="l02103" name="l02103"></a><span class="lineno"> 2103</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02104" name="l02104"></a><span class="lineno"> 2104</span> </div>
<div class="line"><a id="l02105" name="l02105"></a><span class="lineno"> 2105</span>  <span class="keyword">const</span> <span class="keyword">auto</span> mdt_root</div>
<div class="line"><a id="l02106" name="l02106"></a><span class="lineno"> 2106</span>    = connect_else_open ? req_msg.body_root()-&gt;initLogInReq().initMetadata()</div>
<div class="line"><a id="l02107" name="l02107"></a><span class="lineno"> 2107</span>                        : req_msg.body_root()-&gt;initOpenChannelToServerReq().initMetadata();</div>
<div class="line"><a id="l02108" name="l02108"></a><span class="lineno"> 2108</span> </div>
<div class="line"><a id="l02109" name="l02109"></a><span class="lineno"> 2109</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#abe6c733821534ec020b7cec02cfc3e66">Master_channel_req_ptr</a> req_ptr(<span class="keyword">new</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html">Master_channel_req</a>{ mdt_root, std::move(req_msg) });</div>
<div class="line"><a id="l02110" name="l02110"></a><span class="lineno"> 2110</span>  <span class="keywordflow">return</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a9d93e6080abf3b0827b97e084f5e8356">Mdt_builder_ptr</a>(std::move(req_ptr), &amp;req_ptr-&gt;m_mdt_builder);</div>
<div class="line"><a id="l02111" name="l02111"></a><span class="lineno"> 2111</span>} <span class="comment">// Client_session_impl::mdt_builder()</span></div>
<div class="line"><a id="l02112" name="l02112"></a><span class="lineno"> 2112</span> </div>
<div class="line"><a id="l02113" name="l02113"></a><span class="lineno"> 2113</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02114" name="l02114"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a4a377590fbf55b6d312f24d888d2a1bd"> 2114</a></span><span class="keywordtype">bool</span> CLASS_CLI_SESSION_IMPL::open_channel(<a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>* target_channel, <span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a9d93e6080abf3b0827b97e084f5e8356">Mdt_builder_ptr</a>&amp; mdt,</div>
<div class="line"><a id="l02115" name="l02115"></a><span class="lineno"> 2115</span>                                          <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code)</div>
<div class="line"><a id="l02116" name="l02116"></a><span class="lineno"> 2116</span>{</div>
<div class="line"><a id="l02117" name="l02117"></a><span class="lineno"> 2117</span>  <span class="keyword">using </span><a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a>;</div>
<div class="line"><a id="l02118" name="l02118"></a><span class="lineno"> 2118</span>  <span class="keyword">using </span>schema::detail::OpenChannelResult;</div>
<div class="line"><a id="l02119" name="l02119"></a><span class="lineno"> 2119</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l02120" name="l02120"></a><span class="lineno"> 2120</span>  <span class="keyword">using </span>boost::chrono::milliseconds;</div>
<div class="line"><a id="l02121" name="l02121"></a><span class="lineno"> 2121</span>  <span class="keyword">using </span>boost::chrono::round;</div>
<div class="line"><a id="l02122" name="l02122"></a><span class="lineno"> 2122</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l02123" name="l02123"></a><span class="lineno"> 2123</span> </div>
<div class="line"><a id="l02124" name="l02124"></a><span class="lineno"> 2124</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l02125" name="l02125"></a><span class="lineno"> 2125</span> </div>
<div class="line"><a id="l02126" name="l02126"></a><span class="lineno"> 2126</span>  FLOW_ERROR_EXEC_AND_THROW_ON_ERROR(<span class="keywordtype">bool</span>, open_channel, target_channel, mdt, _1);</div>
<div class="line"><a id="l02127" name="l02127"></a><span class="lineno"> 2127</span>  <span class="comment">// ^-- Call ourselves and return if err_code is null.  If got to present line, err_code is not null.</span></div>
<div class="line"><a id="l02128" name="l02128"></a><span class="lineno"> 2128</span> </div>
<div class="line"><a id="l02129" name="l02129"></a><span class="lineno"> 2129</span>  <span class="keywordflow">if</span> (!mdt)</div>
<div class="line"><a id="l02130" name="l02130"></a><span class="lineno"> 2130</span>  {</div>
<div class="line"><a id="l02131" name="l02131"></a><span class="lineno"> 2131</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: &quot;</span></div>
<div class="line"><a id="l02132" name="l02132"></a><span class="lineno"> 2132</span>                     <span class="stringliteral">&quot;null metadata-builder passed-in; either user error passing in null; or more likely &quot;</span></div>
<div class="line"><a id="l02133" name="l02133"></a><span class="lineno"> 2133</span>                     <span class="stringliteral">&quot;that routine failed and returned null, meaning an incoming-direction error was or is being &quot;</span></div>
<div class="line"><a id="l02134" name="l02134"></a><span class="lineno"> 2134</span>                     <span class="stringliteral">&quot;emitted to the on-error handler.  Emitting code-less failure in this synchronous path.&quot;</span>);</div>
<div class="line"><a id="l02135" name="l02135"></a><span class="lineno"> 2135</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l02136" name="l02136"></a><span class="lineno"> 2136</span>  }</div>
<div class="line"><a id="l02137" name="l02137"></a><span class="lineno"> 2137</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02138" name="l02138"></a><span class="lineno"> 2138</span> </div>
<div class="line"><a id="l02139" name="l02139"></a><span class="lineno"> 2139</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: The blocking, but presumed &quot;</span></div>
<div class="line"><a id="l02140" name="l02140"></a><span class="lineno"> 2140</span>                <span class="stringliteral">&quot;sufficiently quick to be considered non-blocking, request-response exchange initiating; timeout set &quot;</span></div>
<div class="line"><a id="l02141" name="l02141"></a><span class="lineno"> 2141</span>                <span class="stringliteral">&quot;to a generous [&quot;</span> &lt;&lt; round&lt;milliseconds&gt;(Base::S_OPEN_CHANNEL_TIMEOUT) &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l02142" name="l02142"></a><span class="lineno"> 2142</span> </div>
<div class="line"><a id="l02143" name="l02143"></a><span class="lineno"> 2143</span>  <span class="comment">/* As usual do all the work in thread W, where we can access m_master_channel and m_state among other things.</span></div>
<div class="line"><a id="l02144" name="l02144"></a><span class="lineno"> 2144</span><span class="comment">   * We do need to return the results of the operation here in thread U though. */</span></div>
<div class="line"><a id="l02145" name="l02145"></a><span class="lineno"> 2145</span>  <span class="keywordtype">bool</span> sync_error_but_do_not_emit = <span class="keyword">false</span>; <span class="comment">// If this ends up true, err_code is ignored and clear()ed ultimately.</span></div>
<div class="line"><a id="l02146" name="l02146"></a><span class="lineno"> 2146</span>  <span class="comment">// If it ends up false, *err_code will indicate either success or non-fatal error.</span></div>
<div class="line"><a id="l02147" name="l02147"></a><span class="lineno"> 2147</span> </div>
<div class="line"><a id="l02148" name="l02148"></a><span class="lineno"> 2148</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l02149" name="l02149"></a><span class="lineno"> 2149</span>  {</div>
<div class="line"><a id="l02150" name="l02150"></a><span class="lineno"> 2150</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l02151" name="l02151"></a><span class="lineno"> 2151</span> </div>
<div class="line"><a id="l02152" name="l02152"></a><span class="lineno"> 2152</span>    assert((m_state == State::S_PEER)</div>
<div class="line"><a id="l02153" name="l02153"></a><span class="lineno"> 2153</span>           &amp;&amp; <span class="stringliteral">&quot;mdt is non-null, yet state is not PEER, even though PEER is an end state?  Bug.&quot;</span>);</div>
<div class="line"><a id="l02154" name="l02154"></a><span class="lineno"> 2154</span> </div>
<div class="line"><a id="l02155" name="l02155"></a><span class="lineno"> 2155</span>    <span class="keywordflow">if</span> (Base::hosed())</div>
<div class="line"><a id="l02156" name="l02156"></a><span class="lineno"> 2156</span>    {</div>
<div class="line"><a id="l02157" name="l02157"></a><span class="lineno"> 2157</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open request send-request stage preempted &quot;</span></div>
<div class="line"><a id="l02158" name="l02158"></a><span class="lineno"> 2158</span>                       <span class="stringliteral">&quot;by earlier session-hosed error.  No-op.&quot;</span>);</div>
<div class="line"><a id="l02159" name="l02159"></a><span class="lineno"> 2159</span>      sync_error_but_do_not_emit = <span class="keyword">true</span>;</div>
<div class="line"><a id="l02160" name="l02160"></a><span class="lineno"> 2160</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02161" name="l02161"></a><span class="lineno"> 2161</span>    }</div>
<div class="line"><a id="l02162" name="l02162"></a><span class="lineno"> 2162</span>    <span class="comment">// else if (!Base::hosed()): We can attempt sync_request() (which could hose us itself).</span></div>
<div class="line"><a id="l02163" name="l02163"></a><span class="lineno"> 2163</span> </div>
<div class="line"><a id="l02164" name="l02164"></a><span class="lineno"> 2164</span>    <span class="keyword">auto</span>&amp; open_channel_req = *(<span class="keyword">reinterpret_cast&lt;</span><a class="code hl_struct" href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html">Master_channel_req</a>*<span class="keyword">&gt;</span>(mdt.get()));</div>
<div class="line"><a id="l02165" name="l02165"></a><span class="lineno"> 2165</span> </div>
<div class="line"><a id="l02166" name="l02166"></a><span class="lineno"> 2166</span>    <span class="comment">// @todo Maybe treat it same as null mdt at open_channel() start?  Currently we promise undefined behavior:</span></div>
<div class="line"><a id="l02167" name="l02167"></a><span class="lineno"> 2167</span>    assert(open_channel_req.m_req_msg.body_root()-&gt;isOpenChannelToServerReq()</div>
<div class="line"><a id="l02168" name="l02168"></a><span class="lineno"> 2168</span>           &amp;&amp; <span class="stringliteral">&quot;Did you pass NULL-state-mdt_builder() result to open_channel()?  Use PEER-state one instead.&quot;</span>);</div>
<div class="line"><a id="l02169" name="l02169"></a><span class="lineno"> 2169</span> </div>
<div class="line"><a id="l02170" name="l02170"></a><span class="lineno"> 2170</span>    <span class="comment">/* Now simply issue the open-channel request prepared already via `mdt` and synchronously</span></div>
<div class="line"><a id="l02171" name="l02171"></a><span class="lineno"> 2171</span><span class="comment">     * await response, or error, or timeout.  struc::Channel::sync_request() is tailor-made for this. */</span></div>
<div class="line"><a id="l02172" name="l02172"></a><span class="lineno"> 2172</span>    <span class="keyword">const</span> <span class="keyword">auto</span> open_channel_rsp = m_master_channel-&gt;sync_request(open_channel_req.m_req_msg, <span class="keyword">nullptr</span>,</div>
<div class="line"><a id="l02173" name="l02173"></a><span class="lineno"> 2173</span>                                                                 Base::S_OPEN_CHANNEL_TIMEOUT, err_code);</div>
<div class="line"><a id="l02174" name="l02174"></a><span class="lineno"> 2174</span> </div>
<div class="line"><a id="l02175" name="l02175"></a><span class="lineno"> 2175</span>    <span class="keywordflow">if</span> ((!open_channel_rsp) &amp;&amp; (!*err_code))</div>
<div class="line"><a id="l02176" name="l02176"></a><span class="lineno"> 2176</span>    {</div>
<div class="line"><a id="l02177" name="l02177"></a><span class="lineno"> 2177</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open request failed at the send-request stage &quot;</span></div>
<div class="line"><a id="l02178" name="l02178"></a><span class="lineno"> 2178</span>                       <span class="stringliteral">&quot;(due to incoming-direction error which shall hose session around this time).  No-op.&quot;</span>);</div>
<div class="line"><a id="l02179" name="l02179"></a><span class="lineno"> 2179</span>      sync_error_but_do_not_emit = <span class="keyword">true</span>;</div>
<div class="line"><a id="l02180" name="l02180"></a><span class="lineno"> 2180</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02181" name="l02181"></a><span class="lineno"> 2181</span>    }</div>
<div class="line"><a id="l02182" name="l02182"></a><span class="lineno"> 2182</span>    <span class="comment">// else if (*err_code || open_channel_rsp)</span></div>
<div class="line"><a id="l02183" name="l02183"></a><span class="lineno"> 2183</span> </div>
<div class="line"><a id="l02184" name="l02184"></a><span class="lineno"> 2184</span>    <span class="keywordflow">if</span> (*err_code) <span class="comment">// &amp;&amp; !open_channel_rsp)</span></div>
<div class="line"><a id="l02185" name="l02185"></a><span class="lineno"> 2185</span>    {</div>
<div class="line"><a id="l02186" name="l02186"></a><span class="lineno"> 2186</span>      assert((!open_channel_rsp) &amp;&amp; <span class="stringliteral">&quot;struc::Channel::sync_request() must emit no Error_code if it gets response.&quot;</span>);</div>
<div class="line"><a id="l02187" name="l02187"></a><span class="lineno"> 2187</span> </div>
<div class="line"><a id="l02188" name="l02188"></a><span class="lineno"> 2188</span>      <span class="keywordflow">if</span> (*err_code == <a class="code hl_enumvalue" href="namespaceipc_1_1transport_1_1error.html#adfef15ef4e76cc55d652fbd9c2797297abcfca4c2347f9d377dd2ac41c41dc027">transport::error::Code::S_TIMEOUT</a>)</div>
<div class="line"><a id="l02189" name="l02189"></a><span class="lineno"> 2189</span>      {</div>
<div class="line"><a id="l02190" name="l02190"></a><span class="lineno"> 2190</span>        FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: It timed out.  It may &quot;</span></div>
<div class="line"><a id="l02191" name="l02191"></a><span class="lineno"> 2191</span>                         <span class="stringliteral">&quot;complete in the background still, but when it does any result shall be ignored.  &quot;</span></div>
<div class="line"><a id="l02192" name="l02192"></a><span class="lineno"> 2192</span>                         <span class="stringliteral">&quot;Emitting (non-session-hosing) error.&quot;</span>);</div>
<div class="line"><a id="l02193" name="l02193"></a><span class="lineno"> 2193</span> </div>
<div class="line"><a id="l02194" name="l02194"></a><span class="lineno"> 2194</span>        *err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa7d85b87223a9b277b8875c1f7971d6ad">error::Code::S_SESSION_OPEN_CHANNEL_ACTIVE_TIMEOUT</a>;</div>
<div class="line"><a id="l02195" name="l02195"></a><span class="lineno"> 2195</span>        <span class="comment">// Non-session hosing error will be synchronously emitted; *this will continue (as promised).</span></div>
<div class="line"><a id="l02196" name="l02196"></a><span class="lineno"> 2196</span>        <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02197" name="l02197"></a><span class="lineno"> 2197</span>      }</div>
<div class="line"><a id="l02198" name="l02198"></a><span class="lineno"> 2198</span>      <span class="comment">// else if (*err_code truthy but not timeout): Session got hosed.</span></div>
<div class="line"><a id="l02199" name="l02199"></a><span class="lineno"> 2199</span> </div>
<div class="line"><a id="l02200" name="l02200"></a><span class="lineno"> 2200</span>      <span class="comment">/* As promised, open_channel() hosing the session shall be reported asynchronously like all errors;</span></div>
<div class="line"><a id="l02201" name="l02201"></a><span class="lineno"> 2201</span><span class="comment">       * while we will merely return false. */</span></div>
<div class="line"><a id="l02202" name="l02202"></a><span class="lineno"> 2202</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open request failed at the sync-request stage, &quot;</span></div>
<div class="line"><a id="l02203" name="l02203"></a><span class="lineno"> 2203</span>                       <span class="stringliteral">&quot;meaning either the nb-send failed, or in-error detected on channel while waiting for &quot;</span></div>
<div class="line"><a id="l02204" name="l02204"></a><span class="lineno"> 2204</span>                       <span class="stringliteral">&quot;response (new error: [&quot;</span> &lt;&lt; *err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code-&gt;message() &lt;&lt; <span class="stringliteral">&quot;]).  Hosing &quot;</span></div>
<div class="line"><a id="l02205" name="l02205"></a><span class="lineno"> 2205</span>                       <span class="stringliteral">&quot;session (emit to session on-error handler); will synchronously return failure to &quot;</span></div>
<div class="line"><a id="l02206" name="l02206"></a><span class="lineno"> 2206</span>                       <span class="stringliteral">&quot;open channel.&quot;</span>);</div>
<div class="line"><a id="l02207" name="l02207"></a><span class="lineno"> 2207</span>      Base::hose(*err_code);</div>
<div class="line"><a id="l02208" name="l02208"></a><span class="lineno"> 2208</span>      sync_error_but_do_not_emit = <span class="keyword">true</span>; <span class="comment">// err_code is ignored.</span></div>
<div class="line"><a id="l02209" name="l02209"></a><span class="lineno"> 2209</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02210" name="l02210"></a><span class="lineno"> 2210</span>    }</div>
<div class="line"><a id="l02211" name="l02211"></a><span class="lineno"> 2211</span>    <span class="comment">// else if (!*err_code): sync_request() succeeded all the way.</span></div>
<div class="line"><a id="l02212" name="l02212"></a><span class="lineno"> 2212</span>    assert(open_channel_rsp);</div>
<div class="line"><a id="l02213" name="l02213"></a><span class="lineno"> 2213</span> </div>
<div class="line"><a id="l02214" name="l02214"></a><span class="lineno"> 2214</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open request: Request message sent to server &quot;</span></div>
<div class="line"><a id="l02215" name="l02215"></a><span class="lineno"> 2215</span>                   <span class="stringliteral">&quot;sans error, and response received in time.&quot;</span>);</div>
<div class="line"><a id="l02216" name="l02216"></a><span class="lineno"> 2216</span> </div>
<div class="line"><a id="l02217" name="l02217"></a><span class="lineno"> 2217</span>    <span class="keyword">const</span> <span class="keyword">auto</span> root = open_channel_rsp-&gt;body_root().getOpenChannelToServerRsp();</div>
<div class="line"><a id="l02218" name="l02218"></a><span class="lineno"> 2218</span>    <span class="keywordflow">switch</span> (root.getOpenChannelResult())</div>
<div class="line"><a id="l02219" name="l02219"></a><span class="lineno"> 2219</span>    {</div>
<div class="line"><a id="l02220" name="l02220"></a><span class="lineno"> 2220</span>    <span class="keywordflow">case</span> OpenChannelResult::ACCEPTED:</div>
<div class="line"><a id="l02221" name="l02221"></a><span class="lineno"> 2221</span>      assert(!*err_code);</div>
<div class="line"><a id="l02222" name="l02222"></a><span class="lineno"> 2222</span>      <span class="keywordflow">break</span>;</div>
<div class="line"><a id="l02223" name="l02223"></a><span class="lineno"> 2223</span>    <span class="keywordflow">case</span> OpenChannelResult::REJECTED_PASSIVE_OPEN:</div>
<div class="line"><a id="l02224" name="l02224"></a><span class="lineno"> 2224</span>      *err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa2c8c27c65ff6234220a84f96de8a1870">error::Code::S_SESSION_OPEN_CHANNEL_REMOTE_PEER_REJECTED_PASSIVE_OPEN</a>;</div>
<div class="line"><a id="l02225" name="l02225"></a><span class="lineno"> 2225</span>      <span class="keywordflow">break</span>;</div>
<div class="line"><a id="l02226" name="l02226"></a><span class="lineno"> 2226</span>    <span class="keywordflow">case</span> OpenChannelResult::REJECTED_RESOURCE_UNAVAILABLE:</div>
<div class="line"><a id="l02227" name="l02227"></a><span class="lineno"> 2227</span>      *err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa10d32cf1382fb003f09a6df2da408574">error::Code::S_SESSION_OPEN_CHANNEL_SERVER_CANNOT_PROCEED_RESOURCE_UNAVAILABLE</a>;</div>
<div class="line"><a id="l02228" name="l02228"></a><span class="lineno"> 2228</span>      <span class="keywordflow">break</span>;</div>
<div class="line"><a id="l02229" name="l02229"></a><span class="lineno"> 2229</span>    <span class="keywordflow">case</span> OpenChannelResult::END_SENTINEL:</div>
<div class="line"><a id="l02230" name="l02230"></a><span class="lineno"> 2230</span>      assert(<span class="keyword">false</span>);</div>
<div class="line"><a id="l02231" name="l02231"></a><span class="lineno"> 2231</span>    } <span class="comment">// Compiler should catch missing enum value.</span></div>
<div class="line"><a id="l02232" name="l02232"></a><span class="lineno"> 2232</span> </div>
<div class="line"><a id="l02233" name="l02233"></a><span class="lineno"> 2233</span>    <span class="keywordflow">if</span> (*err_code)</div>
<div class="line"><a id="l02234" name="l02234"></a><span class="lineno"> 2234</span>    {</div>
<div class="line"><a id="l02235" name="l02235"></a><span class="lineno"> 2235</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: Response received but &quot;</span></div>
<div class="line"><a id="l02236" name="l02236"></a><span class="lineno"> 2236</span>                       <span class="stringliteral">&quot;indicates remote peer (server) refused/was unable to open channel for us; emitting &quot;</span></div>
<div class="line"><a id="l02237" name="l02237"></a><span class="lineno"> 2237</span>                       <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; *err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code-&gt;message() &lt;&lt; <span class="stringliteral">&quot;] with explanation from remote &quot;</span></div>
<div class="line"><a id="l02238" name="l02238"></a><span class="lineno"> 2238</span>                       <span class="stringliteral">&quot;peer.  This will not hose session on our end.&quot;</span>);</div>
<div class="line"><a id="l02239" name="l02239"></a><span class="lineno"> 2239</span>      <span class="comment">// Note: all of the above are advertised as non-session-hosing.</span></div>
<div class="line"><a id="l02240" name="l02240"></a><span class="lineno"> 2240</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02241" name="l02241"></a><span class="lineno"> 2241</span>    }</div>
<div class="line"><a id="l02242" name="l02242"></a><span class="lineno"> 2242</span>    <span class="comment">// else: Cool! We can open our side of each channel component based on the stuff server prepared and sent to us.</span></div>
<div class="line"><a id="l02243" name="l02243"></a><span class="lineno"> 2243</span> </div>
<div class="line"><a id="l02244" name="l02244"></a><span class="lineno"> 2244</span>    <a class="code hl_typedef" href="namespaceipc_1_1transport.html#a7ee4551983d9df16ec16a3139bac50e8">Native_handle</a> local_hndl_or_null = open_channel_rsp-&gt;native_handle_or_null();</div>
<div class="line"><a id="l02245" name="l02245"></a><span class="lineno"> 2245</span>    <span class="keyword">const</span> <span class="keyword">auto</span> mq_name_c2s_or_none = <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(<span class="keywordtype">string</span>(root.getClientToServerMqAbsNameOrEmpty()));</div>
<div class="line"><a id="l02246" name="l02246"></a><span class="lineno"> 2246</span>    <span class="keyword">const</span> <span class="keyword">auto</span> mq_name_s2c_or_none = <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(<span class="keywordtype">string</span>(root.getServerToClientMqAbsNameOrEmpty()));</div>
<div class="line"><a id="l02247" name="l02247"></a><span class="lineno"> 2247</span> </div>
<div class="line"><a id="l02248" name="l02248"></a><span class="lineno"> 2248</span>    create_channel_obj(mq_name_c2s_or_none, mq_name_s2c_or_none, std::move(local_hndl_or_null),</div>
<div class="line"><a id="l02249" name="l02249"></a><span class="lineno"> 2249</span>                       target_channel, <span class="keyword">true</span>, <span class="comment">// true =&gt; active.</span></div>
<div class="line"><a id="l02250" name="l02250"></a><span class="lineno"> 2250</span>                       err_code);</div>
<div class="line"><a id="l02251" name="l02251"></a><span class="lineno"> 2251</span>    <span class="comment">// *err_code is either success or failure, and target_channel is either blank or a PEER-state Channel.</span></div>
<div class="line"><a id="l02252" name="l02252"></a><span class="lineno"> 2252</span> </div>
<div class="line"><a id="l02253" name="l02253"></a><span class="lineno"> 2253</span>    assert((!*err_code)</div>
<div class="line"><a id="l02254" name="l02254"></a><span class="lineno"> 2254</span>           &amp;&amp; <span class="stringliteral">&quot;As of this writing the only path to this is inside the MQ-related guts of Channel creation (if &quot;</span></div>
<div class="line"><a id="l02255" name="l02255"></a><span class="lineno"> 2255</span>                <span class="stringliteral">&quot;MQs are even configured), namely because something in Blob_stream_mq_base_impl indicates &quot;</span></div>
<div class="line"><a id="l02256" name="l02256"></a><span class="lineno"> 2256</span>                <span class="stringliteral">&quot;there&#39;d be no more than 1 MQ receiver or 1 MQ sender for a given MQ (c2s or s2c) &quot;</span></div>
<div class="line"><a id="l02257" name="l02257"></a><span class="lineno"> 2257</span>                <span class="stringliteral">&quot;and that is *after* server was able to get through its side of the same thing not to mention &quot;</span></div>
<div class="line"><a id="l02258" name="l02258"></a><span class="lineno"> 2258</span>                <span class="stringliteral">&quot;create the MQs in the first place.  We are not supposed to emit REJECTED_RESOURCE_UNAVAILABLE &quot;</span></div>
<div class="line"><a id="l02259" name="l02259"></a><span class="lineno"> 2259</span>                <span class="stringliteral">&quot;since this isn&#39;t even resource acquisition but merely hooking up to the resource acquired &quot;</span></div>
<div class="line"><a id="l02260" name="l02260"></a><span class="lineno"> 2260</span>                <span class="stringliteral">&quot;by server already.  So it is very strange no-man&#39;s-land; we abort.  @todo Reconsider.&quot;</span>);</div>
<div class="line"><a id="l02261" name="l02261"></a><span class="lineno"> 2261</span> </div>
<div class="line"><a id="l02262" name="l02262"></a><span class="lineno"> 2262</span>    FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: Succeeded in time yielding &quot;</span></div>
<div class="line"><a id="l02263" name="l02263"></a><span class="lineno"> 2263</span>                  <span class="stringliteral">&quot;new channel [&quot;</span> &lt;&lt; *target_channel &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l02264" name="l02264"></a><span class="lineno"> 2264</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION); <span class="comment">// m_async_worker.post()</span></div>
<div class="line"><a id="l02265" name="l02265"></a><span class="lineno"> 2265</span> </div>
<div class="line"><a id="l02266" name="l02266"></a><span class="lineno"> 2266</span>  <span class="comment">// It all logged sufficiently.  Just return the results.</span></div>
<div class="line"><a id="l02267" name="l02267"></a><span class="lineno"> 2267</span> </div>
<div class="line"><a id="l02268" name="l02268"></a><span class="lineno"> 2268</span>  <span class="keywordflow">if</span> (sync_error_but_do_not_emit)</div>
<div class="line"><a id="l02269" name="l02269"></a><span class="lineno"> 2269</span>  {</div>
<div class="line"><a id="l02270" name="l02270"></a><span class="lineno"> 2270</span>    err_code-&gt;clear();</div>
<div class="line"><a id="l02271" name="l02271"></a><span class="lineno"> 2271</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l02272" name="l02272"></a><span class="lineno"> 2272</span>  }</div>
<div class="line"><a id="l02273" name="l02273"></a><span class="lineno"> 2273</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02274" name="l02274"></a><span class="lineno"> 2274</span> </div>
<div class="line"><a id="l02275" name="l02275"></a><span class="lineno"> 2275</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// *err_code may be truthy or falsy.</span></div>
<div class="line"><a id="l02276" name="l02276"></a><span class="lineno"> 2276</span>} <span class="comment">// Client_session_impl::open_channel()</span></div>
<div class="line"><a id="l02277" name="l02277"></a><span class="lineno"> 2277</span> </div>
<div class="line"><a id="l02278" name="l02278"></a><span class="lineno"> 2278</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02279" name="l02279"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#acaca4c5b8e56cf4cd29b5cc886993ded"> 2279</a></span><span class="keywordtype">bool</span> CLASS_CLI_SESSION_IMPL::open_channel(<a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>* target_channel, <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code)</div>
<div class="line"><a id="l02280" name="l02280"></a><span class="lineno"> 2280</span>{</div>
<div class="line"><a id="l02281" name="l02281"></a><span class="lineno"> 2281</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l02282" name="l02282"></a><span class="lineno"> 2282</span>  <span class="keywordflow">return</span> open_channel(target_channel, mdt_builder(), err_code);</div>
<div class="line"><a id="l02283" name="l02283"></a><span class="lineno"> 2283</span>}</div>
<div class="line"><a id="l02284" name="l02284"></a><span class="lineno"> 2284</span> </div>
<div class="line"><a id="l02285" name="l02285"></a><span class="lineno"> 2285</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02286" name="l02286"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a84bcd253bb1cd89fcf94233c2f771142"> 2286</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::on_master_channel_open_channel_req</div>
<div class="line"><a id="l02287" name="l02287"></a><span class="lineno"> 2287</span>       (<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; open_channel_req)</div>
<div class="line"><a id="l02288" name="l02288"></a><span class="lineno"> 2288</span>{</div>
<div class="line"><a id="l02289" name="l02289"></a><span class="lineno"> 2289</span>  <span class="keyword">using </span>schema::detail::OpenChannelResult;</div>
<div class="line"><a id="l02290" name="l02290"></a><span class="lineno"> 2290</span>  <span class="keyword">using </span>flow::util::ostream_op_string;</div>
<div class="line"><a id="l02291" name="l02291"></a><span class="lineno"> 2291</span>  <span class="keyword">using </span>boost::shared_ptr;</div>
<div class="line"><a id="l02292" name="l02292"></a><span class="lineno"> 2292</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l02293" name="l02293"></a><span class="lineno"> 2293</span> </div>
<div class="line"><a id="l02294" name="l02294"></a><span class="lineno"> 2294</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l02295" name="l02295"></a><span class="lineno"> 2295</span> </div>
<div class="line"><a id="l02296" name="l02296"></a><span class="lineno"> 2296</span>  <span class="keywordflow">if</span> (Base::hosed())</div>
<div class="line"><a id="l02297" name="l02297"></a><span class="lineno"> 2297</span>  {</div>
<div class="line"><a id="l02298" name="l02298"></a><span class="lineno"> 2298</span>    <span class="comment">/* Another thread-W task hosed the session.  It shouldn&#39;t be due to m_master_channel itself firing error,</span></div>
<div class="line"><a id="l02299" name="l02299"></a><span class="lineno"> 2299</span><span class="comment">     * as then we shouldn&#39;t be called, but maybe our own logic found some session-hosing condition in the meantime. */</span></div>
<div class="line"><a id="l02300" name="l02300"></a><span class="lineno"> 2300</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02301" name="l02301"></a><span class="lineno"> 2301</span>  }</div>
<div class="line"><a id="l02302" name="l02302"></a><span class="lineno"> 2302</span>  <span class="comment">// else if (!Base::hosed()): Our time to shine.  We may make Base::hosed() true ourselves, in peace, below.</span></div>
<div class="line"><a id="l02303" name="l02303"></a><span class="lineno"> 2303</span> </div>
<div class="line"><a id="l02304" name="l02304"></a><span class="lineno"> 2304</span>  <span class="keyword">auto</span> open_channel_rsp = m_master_channel-&gt;create_msg();</div>
<div class="line"><a id="l02305" name="l02305"></a><span class="lineno"> 2305</span>  OpenChannelResult open_channel_result = OpenChannelResult::ACCEPTED;</div>
<div class="line"><a id="l02306" name="l02306"></a><span class="lineno"> 2306</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a> opened_channel;</div>
<div class="line"><a id="l02307" name="l02307"></a><span class="lineno"> 2307</span> </div>
<div class="line"><a id="l02308" name="l02308"></a><span class="lineno"> 2308</span>  <span class="keyword">const</span> <span class="keyword">auto</span>&amp; on_passive_open_func = Base::on_passive_open_channel_func_or_empty();</div>
<div class="line"><a id="l02309" name="l02309"></a><span class="lineno"> 2309</span>  <span class="keywordflow">if</span> (on_passive_open_func.empty())</div>
<div class="line"><a id="l02310" name="l02310"></a><span class="lineno"> 2310</span>  {</div>
<div class="line"><a id="l02311" name="l02311"></a><span class="lineno"> 2311</span>    open_channel_result = OpenChannelResult::REJECTED_PASSIVE_OPEN;</div>
<div class="line"><a id="l02312" name="l02312"></a><span class="lineno"> 2312</span>  }</div>
<div class="line"><a id="l02313" name="l02313"></a><span class="lineno"> 2313</span>  <span class="keywordflow">else</span> <span class="comment">// if (passive opens enabled)</span></div>
<div class="line"><a id="l02314" name="l02314"></a><span class="lineno"> 2314</span>  {</div>
<div class="line"><a id="l02315" name="l02315"></a><span class="lineno"> 2315</span>    <span class="keyword">const</span> <span class="keyword">auto</span> root = open_channel_req-&gt;body_root().getOpenChannelToClientReq();</div>
<div class="line"><a id="l02316" name="l02316"></a><span class="lineno"> 2316</span> </div>
<div class="line"><a id="l02317" name="l02317"></a><span class="lineno"> 2317</span>    <span class="comment">// Cool! We can open our side of each channel component based on the stuff server prepared and sent to us.</span></div>
<div class="line"><a id="l02318" name="l02318"></a><span class="lineno"> 2318</span> </div>
<div class="line"><a id="l02319" name="l02319"></a><span class="lineno"> 2319</span>    <span class="keyword">auto</span> local_hndl_or_null = open_channel_req-&gt;native_handle_or_null();</div>
<div class="line"><a id="l02320" name="l02320"></a><span class="lineno"> 2320</span>    <span class="keyword">const</span> <span class="keyword">auto</span> mq_name_c2s_or_none = <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(<span class="keywordtype">string</span>(root.getClientToServerMqAbsNameOrEmpty()));</div>
<div class="line"><a id="l02321" name="l02321"></a><span class="lineno"> 2321</span>    <span class="keyword">const</span> <span class="keyword">auto</span> mq_name_s2c_or_none = <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(<span class="keywordtype">string</span>(root.getServerToClientMqAbsNameOrEmpty()));</div>
<div class="line"><a id="l02322" name="l02322"></a><span class="lineno"> 2322</span> </div>
<div class="line"><a id="l02323" name="l02323"></a><span class="lineno"> 2323</span>    <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code;</div>
<div class="line"><a id="l02324" name="l02324"></a><span class="lineno"> 2324</span>    create_channel_obj(mq_name_c2s_or_none, mq_name_s2c_or_none, std::move(local_hndl_or_null),</div>
<div class="line"><a id="l02325" name="l02325"></a><span class="lineno"> 2325</span>                       &amp;opened_channel, <span class="keyword">false</span>, <span class="comment">// false =&gt; passive.</span></div>
<div class="line"><a id="l02326" name="l02326"></a><span class="lineno"> 2326</span>                       &amp;err_code);</div>
<div class="line"><a id="l02327" name="l02327"></a><span class="lineno"> 2327</span>    <span class="comment">// err_code is either success or failure, and opened_channel is either blank or a PEER-state Channel.</span></div>
<div class="line"><a id="l02328" name="l02328"></a><span class="lineno"> 2328</span> </div>
<div class="line"><a id="l02329" name="l02329"></a><span class="lineno"> 2329</span>    assert((!err_code)</div>
<div class="line"><a id="l02330" name="l02330"></a><span class="lineno"> 2330</span>           &amp;&amp; <span class="stringliteral">&quot;As of this writing the only path to this is inside the MQ-related guts of Channel creation (if &quot;</span></div>
<div class="line"><a id="l02331" name="l02331"></a><span class="lineno"> 2331</span>                <span class="stringliteral">&quot;MQs are even configured), namely because something in Blob_stream_mq_base_impl indicates &quot;</span></div>
<div class="line"><a id="l02332" name="l02332"></a><span class="lineno"> 2332</span>                <span class="stringliteral">&quot;there&#39;d be no more than 1 MQ receiver or 1 MQ sender for a given MQ (c2s or s2c) &quot;</span></div>
<div class="line"><a id="l02333" name="l02333"></a><span class="lineno"> 2333</span>                <span class="stringliteral">&quot;and that is *after* server was able to get through its side of the same thing not to mention &quot;</span></div>
<div class="line"><a id="l02334" name="l02334"></a><span class="lineno"> 2334</span>                <span class="stringliteral">&quot;create the MQs in the first place.  We are not supposed to emit REJECTED_RESOURCE_UNAVAILABLE &quot;</span></div>
<div class="line"><a id="l02335" name="l02335"></a><span class="lineno"> 2335</span>                <span class="stringliteral">&quot;since this isn&#39;t even resource acquisition but merely hooking up to the resource acquired &quot;</span></div>
<div class="line"><a id="l02336" name="l02336"></a><span class="lineno"> 2336</span>                <span class="stringliteral">&quot;by server already.  So it is very strange no-man&#39;s-land; we abort.  @todo Reconsider.&quot;</span>);</div>
<div class="line"><a id="l02337" name="l02337"></a><span class="lineno"> 2337</span> </div>
<div class="line"><a id="l02338" name="l02338"></a><span class="lineno"> 2338</span>    <span class="comment">// Success!</span></div>
<div class="line"><a id="l02339" name="l02339"></a><span class="lineno"> 2339</span>  } <span class="comment">// else if (passive opens enabled)</span></div>
<div class="line"><a id="l02340" name="l02340"></a><span class="lineno"> 2340</span> </div>
<div class="line"><a id="l02341" name="l02341"></a><span class="lineno"> 2341</span>  <span class="keyword">auto</span> open_channel_rsp_root = open_channel_rsp.body_root()-&gt;initOpenChannelToClientRsp();</div>
<div class="line"><a id="l02342" name="l02342"></a><span class="lineno"> 2342</span>  <span class="keyword">const</span> <span class="keyword">auto</span> open_channel_req_saved = open_channel_req.get(); <span class="comment">// It&#39;ll get move()d away below possibly; just save it.</span></div>
<div class="line"><a id="l02343" name="l02343"></a><span class="lineno"> 2343</span>  open_channel_rsp_root.setOpenChannelResult(open_channel_result);</div>
<div class="line"><a id="l02344" name="l02344"></a><span class="lineno"> 2344</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a> mdt; <span class="comment">// Null for now; set inside below in the success case.</span></div>
<div class="line"><a id="l02345" name="l02345"></a><span class="lineno"> 2345</span> </div>
<div class="line"><a id="l02346" name="l02346"></a><span class="lineno"> 2346</span>  <span class="keywordflow">if</span> (open_channel_result == OpenChannelResult::ACCEPTED)</div>
<div class="line"><a id="l02347" name="l02347"></a><span class="lineno"> 2347</span>  {</div>
<div class="line"><a id="l02348" name="l02348"></a><span class="lineno"> 2348</span>    <span class="comment">/* open_channel_rsp is ready to go.  That&#39;s for us to send.</span></div>
<div class="line"><a id="l02349" name="l02349"></a><span class="lineno"> 2349</span><span class="comment">     * Locally we need to emit opened_channel; that&#39;s ready too.</span></div>
<div class="line"><a id="l02350" name="l02350"></a><span class="lineno"> 2350</span><span class="comment">     * Locally, lastly, we need to emit the channel-open metadata from the open-channel request.  Take care of that</span></div>
<div class="line"><a id="l02351" name="l02351"></a><span class="lineno"> 2351</span><span class="comment">     * now.  We just give them the entire in-message, invisibly, by supplying a shared_ptr&lt;&gt; alias to a little</span></div>
<div class="line"><a id="l02352" name="l02352"></a><span class="lineno"> 2352</span><span class="comment">     * struct that stores the actual in-message and a reader into its metadata sub-field.  Once they drop their alias</span></div>
<div class="line"><a id="l02353" name="l02353"></a><span class="lineno"> 2353</span><span class="comment">     * shared_ptr, the struct will deleted; and since m_req inside it has ref-count=1, that&#39;ll also be dropped,</span></div>
<div class="line"><a id="l02354" name="l02354"></a><span class="lineno"> 2354</span><span class="comment">     * and the in-message can finally RIP.</span></div>
<div class="line"><a id="l02355" name="l02355"></a><span class="lineno"> 2355</span><span class="comment">     *</span></div>
<div class="line"><a id="l02356" name="l02356"></a><span class="lineno"> 2356</span><span class="comment">     * By the way, this is pretty similar to Master_channel_req (see its doc header) on the open_channel() end;</span></div>
<div class="line"><a id="l02357" name="l02357"></a><span class="lineno"> 2357</span><span class="comment">     * but it&#39;s simpler, as no one will ever need to get to the m_req itself anymore -- it just needs to</span></div>
<div class="line"><a id="l02358" name="l02358"></a><span class="lineno"> 2358</span><span class="comment">     * stay alive, as the Reader is backed by its bits. */</span></div>
<div class="line"><a id="l02359" name="l02359"></a><span class="lineno"> 2359</span>    <span class="keyword">struct </span>Req_and_mdt_reader</div>
<div class="line"><a id="l02360" name="l02360"></a><span class="lineno"> 2360</span>    {</div>
<div class="line"><a id="l02361" name="l02361"></a><span class="lineno"> 2361</span>      <span class="keyword">typename</span> Mdt_reader_ptr::element_type m_mdt_reader;</div>
<div class="line"><a id="l02362" name="l02362"></a><span class="lineno"> 2362</span>      <span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr m_req;</div>
<div class="line"><a id="l02363" name="l02363"></a><span class="lineno"> 2363</span>    };</div>
<div class="line"><a id="l02364" name="l02364"></a><span class="lineno"> 2364</span>    shared_ptr&lt;Req_and_mdt_reader&gt; req_and_mdt(<span class="keyword">new</span> Req_and_mdt_reader</div>
<div class="line"><a id="l02365" name="l02365"></a><span class="lineno"> 2365</span>                                                     { open_channel_req-&gt;body_root()</div>
<div class="line"><a id="l02366" name="l02366"></a><span class="lineno"> 2366</span>                                                         .getOpenChannelToClientReq().getMetadata(),</div>
<div class="line"><a id="l02367" name="l02367"></a><span class="lineno"> 2367</span>                                                        std::move(open_channel_req) });</div>
<div class="line"><a id="l02368" name="l02368"></a><span class="lineno"> 2368</span>    mdt = <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">Mdt_reader_ptr</a>(std::move(req_and_mdt), &amp;req_and_mdt-&gt;m_mdt_reader);</div>
<div class="line"><a id="l02369" name="l02369"></a><span class="lineno"> 2369</span>  } <span class="comment">// if (open_channel_result == ACCEPTED)</span></div>
<div class="line"><a id="l02370" name="l02370"></a><span class="lineno"> 2370</span> </div>
<div class="line"><a id="l02371" name="l02371"></a><span class="lineno"> 2371</span>  <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code;</div>
<div class="line"><a id="l02372" name="l02372"></a><span class="lineno"> 2372</span>  <span class="keywordflow">if</span> (!m_master_channel-&gt;send(open_channel_rsp, open_channel_req_saved, &amp;err_code))</div>
<div class="line"><a id="l02373" name="l02373"></a><span class="lineno"> 2373</span>  {</div>
<div class="line"><a id="l02374" name="l02374"></a><span class="lineno"> 2374</span>    <span class="keywordflow">return</span>; <span class="comment">// It&#39;ll fire on_master_channel_error(); not our problem.</span></div>
<div class="line"><a id="l02375" name="l02375"></a><span class="lineno"> 2375</span>  }</div>
<div class="line"><a id="l02376" name="l02376"></a><span class="lineno"> 2376</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02377" name="l02377"></a><span class="lineno"> 2377</span>  <span class="keywordflow">if</span> (err_code)</div>
<div class="line"><a id="l02378" name="l02378"></a><span class="lineno"> 2378</span>  {</div>
<div class="line"><a id="l02379" name="l02379"></a><span class="lineno"> 2379</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Passive open-channel: send() of OpenChannelToClientRsp &quot;</span></div>
<div class="line"><a id="l02380" name="l02380"></a><span class="lineno"> 2380</span>                     <span class="stringliteral">&quot;failed (details above presumably); this hoses the session.  Emitting to user handler.&quot;</span>);</div>
<div class="line"><a id="l02381" name="l02381"></a><span class="lineno"> 2381</span>    Base::hose(err_code);</div>
<div class="line"><a id="l02382" name="l02382"></a><span class="lineno"> 2382</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02383" name="l02383"></a><span class="lineno"> 2383</span>  } <span class="comment">// if (err_code on send())</span></div>
<div class="line"><a id="l02384" name="l02384"></a><span class="lineno"> 2384</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02385" name="l02385"></a><span class="lineno"> 2385</span> </div>
<div class="line"><a id="l02386" name="l02386"></a><span class="lineno"> 2386</span>  <span class="keywordflow">if</span> (open_channel_result != OpenChannelResult::ACCEPTED)</div>
<div class="line"><a id="l02387" name="l02387"></a><span class="lineno"> 2387</span>  {</div>
<div class="line"><a id="l02388" name="l02388"></a><span class="lineno"> 2388</span>    <span class="comment">// Cool.  Well, from our point of view it&#39;s cool; the user has some stuff to figure out on their app protocol level.</span></div>
<div class="line"><a id="l02389" name="l02389"></a><span class="lineno"> 2389</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Passive open-channel: We have rejected passive-open request &quot;</span></div>
<div class="line"><a id="l02390" name="l02390"></a><span class="lineno"> 2390</span>                     <span class="stringliteral">&quot;(reason explained above hopefully).  Response indicating this is sent.  Done.&quot;</span>);</div>
<div class="line"><a id="l02391" name="l02391"></a><span class="lineno"> 2391</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02392" name="l02392"></a><span class="lineno"> 2392</span>  }</div>
<div class="line"><a id="l02393" name="l02393"></a><span class="lineno"> 2393</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02394" name="l02394"></a><span class="lineno"> 2394</span> </div>
<div class="line"><a id="l02395" name="l02395"></a><span class="lineno"> 2395</span>  <span class="comment">// Great!</span></div>
<div class="line"><a id="l02396" name="l02396"></a><span class="lineno"> 2396</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Passive open-channel: Successful on this side!  Response sent; &quot;</span></div>
<div class="line"><a id="l02397" name="l02397"></a><span class="lineno"> 2397</span>                <span class="stringliteral">&quot;remote peer (server) has already established its peer object before sending the request.  &quot;</span></div>
<div class="line"><a id="l02398" name="l02398"></a><span class="lineno"> 2398</span>                <span class="stringliteral">&quot;We emit local peer Channel object [&quot;</span> &lt;&lt; opened_channel &lt;&lt; <span class="stringliteral">&quot;], plus the channel-open metadata, &quot;</span></div>
<div class="line"><a id="l02399" name="l02399"></a><span class="lineno"> 2399</span>                <span class="stringliteral">&quot;to user via passive-channel-open handler.&quot;</span>);</div>
<div class="line"><a id="l02400" name="l02400"></a><span class="lineno"> 2400</span>  on_passive_open_func(std::move(opened_channel), std::move(mdt));</div>
<div class="line"><a id="l02401" name="l02401"></a><span class="lineno"> 2401</span>  FLOW_LOG_TRACE(<span class="stringliteral">&quot;Handler finished.&quot;</span>);</div>
<div class="line"><a id="l02402" name="l02402"></a><span class="lineno"> 2402</span>} <span class="comment">// Client_session_impl::on_master_channel_open_channel_req()</span></div>
<div class="line"><a id="l02403" name="l02403"></a><span class="lineno"> 2403</span> </div>
<div class="line"><a id="l02404" name="l02404"></a><span class="lineno"> 2404</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02405" name="l02405"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a6c67f6c993089dadf16acb47d535cb68"> 2405</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::create_channel_obj(<span class="keyword">const</span> <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>&amp; mq_name_c2s_or_none,</div>
<div class="line"><a id="l02406" name="l02406"></a><span class="lineno"> 2406</span>                                                <span class="keyword">const</span> <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>&amp; mq_name_s2c_or_none,</div>
<div class="line"><a id="l02407" name="l02407"></a><span class="lineno"> 2407</span>                                                <a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a>&amp;&amp; local_hndl_or_null,</div>
<div class="line"><a id="l02408" name="l02408"></a><span class="lineno"> 2408</span>                                                <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>* opened_channel_ptr,</div>
<div class="line"><a id="l02409" name="l02409"></a><span class="lineno"> 2409</span>                                                <span class="keywordtype">bool</span> active_else_passive,</div>
<div class="line"><a id="l02410" name="l02410"></a><span class="lineno"> 2410</span>                                                <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code_ptr)</div>
<div class="line"><a id="l02411" name="l02411"></a><span class="lineno"> 2411</span>{</div>
<div class="line"><a id="l02412" name="l02412"></a><span class="lineno"> 2412</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">transport::sync_io::Native_socket_stream</a>;</div>
<div class="line"><a id="l02413" name="l02413"></a><span class="lineno"> 2413</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1Socket__stream__channel.html">transport::Socket_stream_channel</a>;</div>
<div class="line"><a id="l02414" name="l02414"></a><span class="lineno"> 2414</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1Mqs__channel.html">transport::Mqs_channel</a>;</div>
<div class="line"><a id="l02415" name="l02415"></a><span class="lineno"> 2415</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1Mqs__socket__stream__channel.html">transport::Mqs_socket_stream_channel</a>;</div>
<div class="line"><a id="l02416" name="l02416"></a><span class="lineno"> 2416</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1Socket__stream__channel__of__blobs.html">transport::Socket_stream_channel_of_blobs</a>;</div>
<div class="line"><a id="l02417" name="l02417"></a><span class="lineno"> 2417</span>  <span class="keyword">using </span>flow::util::ostream_op_string;</div>
<div class="line"><a id="l02418" name="l02418"></a><span class="lineno"> 2418</span> </div>
<div class="line"><a id="l02419" name="l02419"></a><span class="lineno"> 2419</span>  assert(err_code_ptr);</div>
<div class="line"><a id="l02420" name="l02420"></a><span class="lineno"> 2420</span>  assert((!*err_code_ptr) &amp;&amp; <span class="stringliteral">&quot;Should start with success code.&quot;</span>);</div>
<div class="line"><a id="l02421" name="l02421"></a><span class="lineno"> 2421</span> </div>
<div class="line"><a id="l02422" name="l02422"></a><span class="lineno"> 2422</span>  <span class="keyword">auto</span>&amp; opened_channel = *opened_channel_ptr;</div>
<div class="line"><a id="l02423" name="l02423"></a><span class="lineno"> 2423</span>  <span class="keyword">const</span> <span class="keyword">auto</span> nickname = active_else_passive ? ostream_op_string(<span class="stringliteral">&quot;active&quot;</span>, ++m_last_actively_opened_channel_id)</div>
<div class="line"><a id="l02424" name="l02424"></a><span class="lineno"> 2424</span>                                            : ostream_op_string(<span class="stringliteral">&quot;passive&quot;</span>, ++m_last_passively_opened_channel_id);</div>
<div class="line"><a id="l02425" name="l02425"></a><span class="lineno"> 2425</span> </div>
<div class="line"><a id="l02426" name="l02426"></a><span class="lineno"> 2426</span>  assert((S_SOCKET_STREAM_ENABLED == (!local_hndl_or_null.null()))</div>
<div class="line"><a id="l02427" name="l02427"></a><span class="lineno"> 2427</span>         &amp;&amp; <span class="stringliteral">&quot;We and server peer agreed on has-socket-stream channel config, yet they failed to send/not-send us &quot;</span></div>
<div class="line"><a id="l02428" name="l02428"></a><span class="lineno"> 2428</span>              <span class="stringliteral">&quot;a native socket handle accordingly.  Other side misbehaved terribly.  @todo Consider emitting error.&quot;</span>);</div>
<div class="line"><a id="l02429" name="l02429"></a><span class="lineno"> 2429</span>  assert((((!S_MQS_ENABLED) == mq_name_c2s_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a861ea6c9ad6672e83bab5c7747b66f7b">empty</a>())</div>
<div class="line"><a id="l02430" name="l02430"></a><span class="lineno"> 2430</span>          &amp;&amp;</div>
<div class="line"><a id="l02431" name="l02431"></a><span class="lineno"> 2431</span>          ((!S_MQS_ENABLED) == mq_name_c2s_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a861ea6c9ad6672e83bab5c7747b66f7b">empty</a>()))</div>
<div class="line"><a id="l02432" name="l02432"></a><span class="lineno"> 2432</span>         &amp;&amp; <span class="stringliteral">&quot;We and server peer agreed on MQ-type channel config, yet they failed to send/not-send us &quot;</span></div>
<div class="line"><a id="l02433" name="l02433"></a><span class="lineno"> 2433</span>              <span class="stringliteral">&quot;the 2 names accordingly.  Other side misbehaved terribly.  @todo Consider emitting error.&quot;</span>);</div>
<div class="line"><a id="l02434" name="l02434"></a><span class="lineno"> 2434</span> </div>
<div class="line"><a id="l02435" name="l02435"></a><span class="lineno"> 2435</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_MQS_ENABLED)</div>
<div class="line"><a id="l02436" name="l02436"></a><span class="lineno"> 2436</span>  {</div>
<div class="line"><a id="l02437" name="l02437"></a><span class="lineno"> 2437</span>    <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code1;</div>
<div class="line"><a id="l02438" name="l02438"></a><span class="lineno"> 2438</span>    <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code2;</div>
<div class="line"><a id="l02439" name="l02439"></a><span class="lineno"> 2439</span>    <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aa4a518c48b0611e13ad4982d067674f7">Persistent_mq_handle_from_cfg</a> mq_c2s(get_logger(), mq_name_c2s_or_none, <a class="code hl_variable" href="namespaceipc_1_1util.html#a6a3a6ec85242d073df96978c63464078">util::OPEN_ONLY</a>, &amp;err_code1);</div>
<div class="line"><a id="l02440" name="l02440"></a><span class="lineno"> 2440</span>    <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#aa4a518c48b0611e13ad4982d067674f7">Persistent_mq_handle_from_cfg</a> mq_s2c(get_logger(), mq_name_s2c_or_none, <a class="code hl_variable" href="namespaceipc_1_1util.html#a6a3a6ec85242d073df96978c63464078">util::OPEN_ONLY</a>, &amp;err_code2);</div>
<div class="line"><a id="l02441" name="l02441"></a><span class="lineno"> 2441</span> </div>
<div class="line"><a id="l02442" name="l02442"></a><span class="lineno"> 2442</span>    <span class="comment">/* Corner case: Server already created underlying MQs, apparently successfully, so on unlikely failure</span></div>
<div class="line"><a id="l02443" name="l02443"></a><span class="lineno"> 2443</span><span class="comment">     * to create the MQ-based channel below it is up to the server to not-leak those underlying MQs.</span></div>
<div class="line"><a id="l02444" name="l02444"></a><span class="lineno"> 2444</span><span class="comment">     * Omitting further discussion, but indeed server side does take care of this non-trivial task. */</span></div>
<div class="line"><a id="l02445" name="l02445"></a><span class="lineno"> 2445</span> </div>
<div class="line"><a id="l02446" name="l02446"></a><span class="lineno"> 2446</span>    <span class="comment">/* @todo Corner case: What to do with the (FD) local_hndl_or_null, if not .null(), on (MQ-related) failure?</span></div>
<div class="line"><a id="l02447" name="l02447"></a><span class="lineno"> 2447</span><span class="comment">     * Maybe we should ::close(local_hndl_or_null.m_native_handle)?  It is quite a corner case; it came from</span></div>
<div class="line"><a id="l02448" name="l02448"></a><span class="lineno"> 2448</span><span class="comment">     * server-side connect_pair(), and they presumably still may hold the other peer FD, and it is connected?</span></div>
<div class="line"><a id="l02449" name="l02449"></a><span class="lineno"> 2449</span><span class="comment">     * It is hard to reason about, as not only did all that already succeed on server end, but *their* MQ stuff</span></div>
<div class="line"><a id="l02450" name="l02450"></a><span class="lineno"> 2450</span><span class="comment">     * succeeded too -- yet ours failed, and we aren&#39;t even creating the MQs, just hooking up to them.</span></div>
<div class="line"><a id="l02451" name="l02451"></a><span class="lineno"> 2451</span><span class="comment">     * This is not very high-priority but still; it might be kinda/sorta an FD leak or something.  What would</span></div>
<div class="line"><a id="l02452" name="l02452"></a><span class="lineno"> 2452</span><span class="comment">     * it mean to ::close() our transmitted &quot;copy&quot; of one of the peer FDs?  Investigate. */</span></div>
<div class="line"><a id="l02453" name="l02453"></a><span class="lineno"> 2453</span> </div>
<div class="line"><a id="l02454" name="l02454"></a><span class="lineno"> 2454</span>    <span class="keywordflow">if</span> ((*err_code_ptr = (err_code1 ? err_code1 : err_code2)))</div>
<div class="line"><a id="l02455" name="l02455"></a><span class="lineno"> 2455</span>    {</div>
<div class="line"><a id="l02456" name="l02456"></a><span class="lineno"> 2456</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Open-channel (active? = [&quot;</span> &lt;&lt; active_else_passive &lt;&lt; <span class="stringliteral">&quot;]): &quot;</span></div>
<div class="line"><a id="l02457" name="l02457"></a><span class="lineno"> 2457</span>                       <span class="stringliteral">&quot;Request or response received and indicates remote peer (server) generated channel &quot;</span></div>
<div class="line"><a id="l02458" name="l02458"></a><span class="lineno"> 2458</span>                       <span class="stringliteral">&quot;resources for us; but we failed to open our side of 1 or both MQs (see above); &quot;</span></div>
<div class="line"><a id="l02459" name="l02459"></a><span class="lineno"> 2459</span>                       <span class="stringliteral">&quot;emitting the first one to fail of the 2 &quot;</span></div>
<div class="line"><a id="l02460" name="l02460"></a><span class="lineno"> 2460</span>                       <span class="stringliteral">&quot;([&quot;</span> &lt;&lt; *err_code_ptr &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code_ptr-&gt;message() &lt;&lt; <span class="stringliteral">&quot;]).&quot;</span>);</div>
<div class="line"><a id="l02461" name="l02461"></a><span class="lineno"> 2461</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02462" name="l02462"></a><span class="lineno"> 2462</span>    }</div>
<div class="line"><a id="l02463" name="l02463"></a><span class="lineno"> 2463</span>    <span class="comment">// else: cool.  Last thing, possibly:</span></div>
<div class="line"><a id="l02464" name="l02464"></a><span class="lineno"> 2464</span> </div>
<div class="line"><a id="l02465" name="l02465"></a><span class="lineno"> 2465</span>    <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_SOCKET_STREAM_ENABLED)</div>
<div class="line"><a id="l02466" name="l02466"></a><span class="lineno"> 2466</span>    {</div>
<div class="line"><a id="l02467" name="l02467"></a><span class="lineno"> 2467</span>      <span class="keyword">static_assert</span>(std::is_same_v&lt;<a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>,</div>
<div class="line"><a id="l02468" name="l02468"></a><span class="lineno"> 2468</span>                                   Mqs_socket_stream_channel&lt;true, Persistent_mq_handle_from_cfg&gt;&gt;, <span class="stringliteral">&quot;Sanity check.&quot;</span>);</div>
<div class="line"><a id="l02469" name="l02469"></a><span class="lineno"> 2469</span>      assert((!local_hndl_or_null.null()) &amp;&amp; <span class="stringliteral">&quot;This has been ascertained 20 ways by now....&quot;</span>);</div>
<div class="line"><a id="l02470" name="l02470"></a><span class="lineno"> 2470</span> </div>
<div class="line"><a id="l02471" name="l02471"></a><span class="lineno"> 2471</span>      opened_channel = <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>(get_logger(), nickname, std::move(mq_c2s), std::move(mq_s2c),</div>
<div class="line"><a id="l02472" name="l02472"></a><span class="lineno"> 2472</span>                                   Native_socket_stream(get_logger(), nickname,</div>
<div class="line"><a id="l02473" name="l02473"></a><span class="lineno"> 2473</span>                                                        std::move(local_hndl_or_null)),</div>
<div class="line"><a id="l02474" name="l02474"></a><span class="lineno"> 2474</span>                                   err_code_ptr);</div>
<div class="line"><a id="l02475" name="l02475"></a><span class="lineno"> 2475</span>    }</div>
<div class="line"><a id="l02476" name="l02476"></a><span class="lineno"> 2476</span>    <span class="keywordflow">else</span> <span class="comment">// if constexpr(!S_SOCKET_STREAM_ENABLED)</span></div>
<div class="line"><a id="l02477" name="l02477"></a><span class="lineno"> 2477</span>    {</div>
<div class="line"><a id="l02478" name="l02478"></a><span class="lineno"> 2478</span>      <span class="keyword">static_assert</span>(std::is_same_v&lt;<a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>,</div>
<div class="line"><a id="l02479" name="l02479"></a><span class="lineno"> 2479</span>                                   Mqs_channel&lt;true, Persistent_mq_handle_from_cfg&gt;&gt;, <span class="stringliteral">&quot;Sanity check.&quot;</span>);</div>
<div class="line"><a id="l02480" name="l02480"></a><span class="lineno"> 2480</span>      assert(local_hndl_or_null.null() &amp;&amp; <span class="stringliteral">&quot;This has been ascertained 20 ways by now....&quot;</span>);</div>
<div class="line"><a id="l02481" name="l02481"></a><span class="lineno"> 2481</span> </div>
<div class="line"><a id="l02482" name="l02482"></a><span class="lineno"> 2482</span>      opened_channel = <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>(get_logger(), nickname, std::move(mq_c2s), std::move(mq_s2c),</div>
<div class="line"><a id="l02483" name="l02483"></a><span class="lineno"> 2483</span>                                   err_code_ptr);</div>
<div class="line"><a id="l02484" name="l02484"></a><span class="lineno"> 2484</span>    } <span class="comment">// else if constexpr(!S_SOCKET_STREAM_ENABLED)</span></div>
<div class="line"><a id="l02485" name="l02485"></a><span class="lineno"> 2485</span> </div>
<div class="line"><a id="l02486" name="l02486"></a><span class="lineno"> 2486</span>    <span class="keywordflow">if</span> (*err_code_ptr)</div>
<div class="line"><a id="l02487" name="l02487"></a><span class="lineno"> 2487</span>    {</div>
<div class="line"><a id="l02488" name="l02488"></a><span class="lineno"> 2488</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Open-channel (active? = [&quot;</span> &lt;&lt; active_else_passive &lt;&lt; <span class="stringliteral">&quot;]): &quot;</span></div>
<div class="line"><a id="l02489" name="l02489"></a><span class="lineno"> 2489</span>                       <span class="stringliteral">&quot;Request or response received and indicates remote peer (server) generated channel &quot;</span></div>
<div class="line"><a id="l02490" name="l02490"></a><span class="lineno"> 2490</span>                       <span class="stringliteral">&quot;resources for us; but we failed to create the channel due to something MQ-related, &quot;</span></div>
<div class="line"><a id="l02491" name="l02491"></a><span class="lineno"> 2491</span>                       <span class="stringliteral">&quot;even though MQ handles themselves opened fine; emitting &quot;</span></div>
<div class="line"><a id="l02492" name="l02492"></a><span class="lineno"> 2492</span>                       <span class="stringliteral">&quot;([&quot;</span> &lt;&lt; *err_code_ptr &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code_ptr-&gt;message() &lt;&lt; <span class="stringliteral">&quot;]).&quot;</span>);</div>
<div class="line"><a id="l02493" name="l02493"></a><span class="lineno"> 2493</span>    }</div>
<div class="line"><a id="l02494" name="l02494"></a><span class="lineno"> 2494</span>    <span class="comment">// else { All good.  Still done (falsy *err_code_ptr). }</span></div>
<div class="line"><a id="l02495" name="l02495"></a><span class="lineno"> 2495</span>  } <span class="comment">// if constexpr(S_MQS_ENABLED)</span></div>
<div class="line"><a id="l02496" name="l02496"></a><span class="lineno"> 2496</span>  <span class="keywordflow">else</span> <span class="comment">// if constexpr(!S_MQS_ENABLED)</span></div>
<div class="line"><a id="l02497" name="l02497"></a><span class="lineno"> 2497</span>  {</div>
<div class="line"><a id="l02498" name="l02498"></a><span class="lineno"> 2498</span>    <span class="keyword">static_assert</span>(S_SOCKET_STREAM_ENABLED, <span class="stringliteral">&quot;Either MQs or socket stream or both must be configured on somehow.&quot;</span>);</div>
<div class="line"><a id="l02499" name="l02499"></a><span class="lineno"> 2499</span>    assert((!local_hndl_or_null.null()) &amp;&amp; <span class="stringliteral">&quot;One of the pipes must enabled; runtime stuff asserted above already.&quot;</span>);</div>
<div class="line"><a id="l02500" name="l02500"></a><span class="lineno"> 2500</span> </div>
<div class="line"><a id="l02501" name="l02501"></a><span class="lineno"> 2501</span>    <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_TRANSMIT_NATIVE_HANDLES)</div>
<div class="line"><a id="l02502" name="l02502"></a><span class="lineno"> 2502</span>    {</div>
<div class="line"><a id="l02503" name="l02503"></a><span class="lineno"> 2503</span>      <span class="keyword">static_assert</span>(std::is_same_v&lt;Channel_obj, Socket_stream_channel&lt;true&gt;&gt;, <span class="stringliteral">&quot;Sanity check.&quot;</span>);</div>
<div class="line"><a id="l02504" name="l02504"></a><span class="lineno"> 2504</span>      opened_channel</div>
<div class="line"><a id="l02505" name="l02505"></a><span class="lineno"> 2505</span>        = <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>(get_logger(), nickname,</div>
<div class="line"><a id="l02506" name="l02506"></a><span class="lineno"> 2506</span>                      Native_socket_stream(get_logger(), nickname, std::move(local_hndl_or_null)));</div>
<div class="line"><a id="l02507" name="l02507"></a><span class="lineno"> 2507</span>    }</div>
<div class="line"><a id="l02508" name="l02508"></a><span class="lineno"> 2508</span>    <span class="keywordflow">else</span></div>
<div class="line"><a id="l02509" name="l02509"></a><span class="lineno"> 2509</span>    {</div>
<div class="line"><a id="l02510" name="l02510"></a><span class="lineno"> 2510</span>      <span class="keyword">static_assert</span>(std::is_same_v&lt;Channel_obj, Socket_stream_channel_of_blobs&lt;true&gt;&gt;, <span class="stringliteral">&quot;Sanity check.&quot;</span>);</div>
<div class="line"><a id="l02511" name="l02511"></a><span class="lineno"> 2511</span>      opened_channel</div>
<div class="line"><a id="l02512" name="l02512"></a><span class="lineno"> 2512</span>        = <a class="code hl_typedef" href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">Channel_obj</a>(get_logger(), nickname,</div>
<div class="line"><a id="l02513" name="l02513"></a><span class="lineno"> 2513</span>                      Native_socket_stream(get_logger(), nickname, std::move(local_hndl_or_null)));</div>
<div class="line"><a id="l02514" name="l02514"></a><span class="lineno"> 2514</span>    } <span class="comment">// else if constexpr(!S_TRANSMIT_NATIVE_HANDLES)</span></div>
<div class="line"><a id="l02515" name="l02515"></a><span class="lineno"> 2515</span>  } <span class="comment">// if constexpr(!S_MQS_ENABLED)</span></div>
<div class="line"><a id="l02516" name="l02516"></a><span class="lineno"> 2516</span>} <span class="comment">// Client_session_impl::create_channel_obj()</span></div>
<div class="line"><a id="l02517" name="l02517"></a><span class="lineno"> 2517</span> </div>
<div class="line"><a id="l02518" name="l02518"></a><span class="lineno"> 2518</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02519" name="l02519"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a43d56aeae47d1fa815178ebd0ae1ff48"> 2519</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::cancel_peer_state_to_null()</div>
<div class="line"><a id="l02520" name="l02520"></a><span class="lineno"> 2520</span>{</div>
<div class="line"><a id="l02521" name="l02521"></a><span class="lineno"> 2521</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l02522" name="l02522"></a><span class="lineno"> 2522</span>  assert(m_async_worker.in_thread()</div>
<div class="line"><a id="l02523" name="l02523"></a><span class="lineno"> 2523</span>         &amp;&amp; <span class="stringliteral">&quot;By contract this internal/protected API must be invoked from our own thread W (from &quot;</span></div>
<div class="line"><a id="l02524" name="l02524"></a><span class="lineno"> 2524</span>               <span class="stringliteral">&quot;on-async-connect-success handler).&quot;</span>);</div>
<div class="line"><a id="l02525" name="l02525"></a><span class="lineno"> 2525</span> </div>
<div class="line"><a id="l02526" name="l02526"></a><span class="lineno"> 2526</span>  FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: While the vanilla portion of async-connect succeeded, &quot;</span></div>
<div class="line"><a id="l02527" name="l02527"></a><span class="lineno"> 2527</span>                   <span class="stringliteral">&quot;the post-vanilla post-processing portion then synchronously detected a problem; hence we are &quot;</span></div>
<div class="line"><a id="l02528" name="l02528"></a><span class="lineno"> 2528</span>                   <span class="stringliteral">&quot;returning to NULL state after all.&quot;</span>);</div>
<div class="line"><a id="l02529" name="l02529"></a><span class="lineno"> 2529</span> </div>
<div class="line"><a id="l02530" name="l02530"></a><span class="lineno"> 2530</span>  <span class="comment">// Do what we would have done just before calling on_done_func(&lt;failure&gt;) (see on_master_channel_log_in_rsp()).</span></div>
<div class="line"><a id="l02531" name="l02531"></a><span class="lineno"> 2531</span>  m_master_channel.reset();</div>
<div class="line"><a id="l02532" name="l02532"></a><span class="lineno"> 2532</span>  m_state = State::S_NULL;</div>
<div class="line"><a id="l02533" name="l02533"></a><span class="lineno"> 2533</span>}</div>
<div class="line"><a id="l02534" name="l02534"></a><span class="lineno"> 2534</span> </div>
<div class="line"><a id="l02535" name="l02535"></a><span class="lineno"> 2535</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02536" name="l02536"></a><span class="lineno"> 2536</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l02537" name="l02537"></a><span class="lineno"> 2537</span><span class="keyword">typename</span> CLASS_CLI_SESSION_IMPL::Master_structured_channel*</div>
<div class="line"><a id="l02538" name="l02538"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#adac4cba3aefa629566f182a240b4cedd"> 2538</a></span>  CLASS_CLI_SESSION_IMPL::cancel_peer_state_to_connecting(Task_err&amp;&amp; on_done_func)</div>
<div class="line"><a id="l02539" name="l02539"></a><span class="lineno"> 2539</span>{</div>
<div class="line"><a id="l02540" name="l02540"></a><span class="lineno"> 2540</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l02541" name="l02541"></a><span class="lineno"> 2541</span>  assert(m_async_worker.in_thread()</div>
<div class="line"><a id="l02542" name="l02542"></a><span class="lineno"> 2542</span>         &amp;&amp; <span class="stringliteral">&quot;By contract this internal/protected API must be invoked from our own thread W (from &quot;</span></div>
<div class="line"><a id="l02543" name="l02543"></a><span class="lineno"> 2543</span>               <span class="stringliteral">&quot;on-async-connect-success handler).&quot;</span>);</div>
<div class="line"><a id="l02544" name="l02544"></a><span class="lineno"> 2544</span> </div>
<div class="line"><a id="l02545" name="l02545"></a><span class="lineno"> 2545</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: While the vanilla portion of async-connect succeeded, &quot;</span></div>
<div class="line"><a id="l02546" name="l02546"></a><span class="lineno"> 2546</span>                <span class="stringliteral">&quot;the post-vanilla post-processing portion requires further asynchronous work (e.g., to acquire &quot;</span></div>
<div class="line"><a id="l02547" name="l02547"></a><span class="lineno"> 2547</span>                <span class="stringliteral">&quot;additional resources for internal SHM-support purposes); hence we are &quot;</span></div>
<div class="line"><a id="l02548" name="l02548"></a><span class="lineno"> 2548</span>                <span class="stringliteral">&quot;returning to CONNECTING state.&quot;</span>);</div>
<div class="line"><a id="l02549" name="l02549"></a><span class="lineno"> 2549</span> </div>
<div class="line"><a id="l02550" name="l02550"></a><span class="lineno"> 2550</span>  m_state = State::S_CONNECTING;</div>
<div class="line"><a id="l02551" name="l02551"></a><span class="lineno"> 2551</span>  m_conn_on_done_func_or_empty = std::move(on_done_func); <span class="comment">// Again: May be invoked from thread W or thread U (dtor).</span></div>
<div class="line"><a id="l02552" name="l02552"></a><span class="lineno"> 2552</span> </div>
<div class="line"><a id="l02553" name="l02553"></a><span class="lineno"> 2553</span>  <span class="keywordflow">return</span> m_master_channel.get();</div>
<div class="line"><a id="l02554" name="l02554"></a><span class="lineno"> 2554</span>}</div>
<div class="line"><a id="l02555" name="l02555"></a><span class="lineno"> 2555</span> </div>
<div class="line"><a id="l02556" name="l02556"></a><span class="lineno"> 2556</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02557" name="l02557"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a313e2fc3d4017232bad4fac2baae20a4"> 2557</a></span><span class="keywordtype">void</span> CLASS_CLI_SESSION_IMPL::complete_async_connect_after_canceling_peer_state(<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; err_code_or_success)</div>
<div class="line"><a id="l02558" name="l02558"></a><span class="lineno"> 2558</span>{</div>
<div class="line"><a id="l02559" name="l02559"></a><span class="lineno"> 2559</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l02560" name="l02560"></a><span class="lineno"> 2560</span>  assert(m_async_worker.in_thread()</div>
<div class="line"><a id="l02561" name="l02561"></a><span class="lineno"> 2561</span>         &amp;&amp; <span class="stringliteral">&quot;By contract this internal/protected API must be invoked from our own thread W.&quot;</span>);</div>
<div class="line"><a id="l02562" name="l02562"></a><span class="lineno"> 2562</span> </div>
<div class="line"><a id="l02563" name="l02563"></a><span class="lineno"> 2563</span>  assert((!Base::hosed()) &amp;&amp; <span class="stringliteral">&quot;Per contract caller should avoid calling us if already hosed.&quot;</span>);</div>
<div class="line"><a id="l02564" name="l02564"></a><span class="lineno"> 2564</span> </div>
<div class="line"><a id="l02565" name="l02565"></a><span class="lineno"> 2565</span>  <span class="keywordflow">if</span> (err_code_or_success)</div>
<div class="line"><a id="l02566" name="l02566"></a><span class="lineno"> 2566</span>  {</div>
<div class="line"><a id="l02567" name="l02567"></a><span class="lineno"> 2567</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Post-vanilla-success portion of async-connect failed (details &quot;</span></div>
<div class="line"><a id="l02568" name="l02568"></a><span class="lineno"> 2568</span>                     <span class="stringliteral">&quot;surely above).  Executing handler.&quot;</span>);</div>
<div class="line"><a id="l02569" name="l02569"></a><span class="lineno"> 2569</span> </div>
<div class="line"><a id="l02570" name="l02570"></a><span class="lineno"> 2570</span>    <span class="comment">// Similarly to cancel_peer_state_to_null():</span></div>
<div class="line"><a id="l02571" name="l02571"></a><span class="lineno"> 2571</span>    m_master_channel.reset();</div>
<div class="line"><a id="l02572" name="l02572"></a><span class="lineno"> 2572</span>    m_state = State::S_NULL;</div>
<div class="line"><a id="l02573" name="l02573"></a><span class="lineno"> 2573</span>  }</div>
<div class="line"><a id="l02574" name="l02574"></a><span class="lineno"> 2574</span>  <span class="keywordflow">else</span></div>
<div class="line"><a id="l02575" name="l02575"></a><span class="lineno"> 2575</span>  {</div>
<div class="line"><a id="l02576" name="l02576"></a><span class="lineno"> 2576</span>    FLOW_LOG_INFO(<span class="stringliteral">&quot;Client session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Post-vanilla-success portion of async-connect also succeeded.  &quot;</span></div>
<div class="line"><a id="l02577" name="l02577"></a><span class="lineno"> 2577</span>                  <span class="stringliteral">&quot;Will go to PEER state and report to user via on-async-connect handler.&quot;</span>);</div>
<div class="line"><a id="l02578" name="l02578"></a><span class="lineno"> 2578</span>    m_state = State::S_PEER;</div>
<div class="line"><a id="l02579" name="l02579"></a><span class="lineno"> 2579</span> </div>
<div class="line"><a id="l02580" name="l02580"></a><span class="lineno"> 2580</span>    <span class="comment">// See Session_base::Graceful_finisher doc header for all the background ever.</span></div>
<div class="line"><a id="l02581" name="l02581"></a><span class="lineno"> 2581</span>    <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_GRACEFUL_FINISH_REQUIRED)</div>
<div class="line"><a id="l02582" name="l02582"></a><span class="lineno"> 2582</span>    {</div>
<div class="line"><a id="l02583" name="l02583"></a><span class="lineno"> 2583</span>      m_graceful_finisher.emplace(get_logger(), <span class="keyword">this</span>, &amp;m_async_worker, m_master_channel.get());</div>
<div class="line"><a id="l02584" name="l02584"></a><span class="lineno"> 2584</span>    }</div>
<div class="line"><a id="l02585" name="l02585"></a><span class="lineno"> 2585</span>  }</div>
<div class="line"><a id="l02586" name="l02586"></a><span class="lineno"> 2586</span> </div>
<div class="line"><a id="l02587" name="l02587"></a><span class="lineno"> 2587</span>  invoke_conn_on_done_func(err_code_or_success);</div>
<div class="line"><a id="l02588" name="l02588"></a><span class="lineno"> 2588</span>} <span class="comment">// Client_session_impl::complete_async_connect_after_canceling_peer_state()</span></div>
<div class="line"><a id="l02589" name="l02589"></a><span class="lineno"> 2589</span> </div>
<div class="line"><a id="l02590" name="l02590"></a><span class="lineno"> 2590</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02591" name="l02591"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#ab792f2389fd035827ae8dbead1650b78"> 2591</a></span>flow::async::Single_thread_task_loop* CLASS_CLI_SESSION_IMPL::async_worker()</div>
<div class="line"><a id="l02592" name="l02592"></a><span class="lineno"> 2592</span>{</div>
<div class="line"><a id="l02593" name="l02593"></a><span class="lineno"> 2593</span>  <span class="keywordflow">return</span> &amp;m_async_worker;</div>
<div class="line"><a id="l02594" name="l02594"></a><span class="lineno"> 2594</span>}</div>
<div class="line"><a id="l02595" name="l02595"></a><span class="lineno"> 2595</span> </div>
<div class="line"><a id="l02596" name="l02596"></a><span class="lineno"> 2596</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02597" name="l02597"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a5f156b23ce19cd878c3e83330e63f56f"> 2597</a></span><span class="keyword">const</span> <span class="keyword">typename</span> CLASS_CLI_SESSION_IMPL::Master_structured_channel&amp; CLASS_CLI_SESSION_IMPL::master_channel_const()<span class="keyword"> const</span></div>
<div class="line"><a id="l02598" name="l02598"></a><span class="lineno"> 2598</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02599" name="l02599"></a><span class="lineno"> 2599</span>  <span class="keywordflow">return</span> *m_master_channel;</div>
<div class="line"><a id="l02600" name="l02600"></a><span class="lineno"> 2600</span>}</div>
<div class="line"><a id="l02601" name="l02601"></a><span class="lineno"> 2601</span> </div>
<div class="line"><a id="l02602" name="l02602"></a><span class="lineno"> 2602</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div>
<div class="line"><a id="l02603" name="l02603"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Client__session__impl.html#a7c3b6df1a8dab3a2c31b3ad492aa5d8a"> 2603</a></span>std::ostream&amp; <a class="code hl_function" href="namespaceipc_1_1session.html#a6b2f9a90ac9cc5098d9b90e7f547c97e">operator&lt;&lt;</a>(std::ostream&amp; os, <span class="keyword">const</span> <a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a2442fdb91128ae6d1a2bbacc7fd03c9b">CLASS_CLI_SESSION_IMPL</a>&amp; val)</div>
<div class="line"><a id="l02604" name="l02604"></a><span class="lineno"> 2604</span>{</div>
<div class="line"><a id="l02605" name="l02605"></a><span class="lineno"> 2605</span>  <span class="comment">/* Let&#39;s print only really key stuff here; various internal code likes to ostream&lt;&lt; *this session (`val` to us),</span></div>
<div class="line"><a id="l02606" name="l02606"></a><span class="lineno"> 2606</span><span class="comment">   * and we don&#39;t want to be treating stuff here as immutable or safe to access, even though it might change</span></div>
<div class="line"><a id="l02607" name="l02607"></a><span class="lineno"> 2607</span><span class="comment">   * concurrently.  So we intentionally just print the Client_app and the Server_app (which are themselves immutable,</span></div>
<div class="line"><a id="l02608" name="l02608"></a><span class="lineno"> 2608</span><span class="comment">   * but the ref/ptr to each inside `val` might not be).  Now, for Client_session, both ptrs/refs are indeed</span></div>
<div class="line"><a id="l02609" name="l02609"></a><span class="lineno"> 2609</span><span class="comment">   * immutable, so it&#39;s safe. */</span></div>
<div class="line"><a id="l02610" name="l02610"></a><span class="lineno"> 2610</span> </div>
<div class="line"><a id="l02611" name="l02611"></a><span class="lineno"> 2611</span>  <span class="keyword">const</span> <span class="keyword">auto</span> cli_app_ptr = val.cli_app_ptr();</div>
<div class="line"><a id="l02612" name="l02612"></a><span class="lineno"> 2612</span>  assert(cli_app_ptr &amp;&amp; <span class="stringliteral">&quot;Client_session&#39;s Client_app ptr must be known from construction.&quot;</span>);</div>
<div class="line"><a id="l02613" name="l02613"></a><span class="lineno"> 2613</span>  os &lt;&lt; <span class="charliteral">&#39;[&#39;</span> &lt;&lt; cli_app_ptr-&gt;m_name &lt;&lt; <span class="stringliteral">&quot;-&gt;&quot;</span> &lt;&lt; val.m_srv_app_ref.m_name;</div>
<div class="line"><a id="l02614" name="l02614"></a><span class="lineno"> 2614</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(CLASS_CLI_SESSION_IMPL::S_SHM_ENABLED)</div>
<div class="line"><a id="l02615" name="l02615"></a><span class="lineno"> 2615</span>  {</div>
<div class="line"><a id="l02616" name="l02616"></a><span class="lineno"> 2616</span>    os &lt;&lt; <span class="stringliteral">&quot; | shm_type=&quot;</span> &lt;&lt; int(CLASS_CLI_SESSION_IMPL::S_SHM_TYPE);</div>
<div class="line"><a id="l02617" name="l02617"></a><span class="lineno"> 2617</span>  }</div>
<div class="line"><a id="l02618" name="l02618"></a><span class="lineno"> 2618</span>  <span class="keywordflow">return</span> os &lt;&lt; <span class="stringliteral">&quot;]@&quot;</span> &lt;&lt; <span class="keyword">static_cast&lt;</span><span class="keyword">const </span><span class="keywordtype">void</span>*<span class="keyword">&gt;</span>(&amp;val);</div>
<div class="line"><a id="l02619" name="l02619"></a><span class="lineno"> 2619</span>}</div>
<div class="line"><a id="l02620" name="l02620"></a><span class="lineno"> 2620</span> </div>
<div class="line"><a id="l02621" name="l02621"></a><span class="lineno"> 2621</span><span class="preprocessor">#undef CLASS_CLI_SESSION_IMPL</span></div>
<div class="line"><a id="l02622" name="l02622"></a><span class="lineno"> 2622</span><span class="preprocessor">#undef TEMPLATE_CLI_SESSION_IMPL</span></div>
<div class="line"><a id="l02623" name="l02623"></a><span class="lineno"> 2623</span> </div>
<div class="line"><a id="l02624" name="l02624"></a><span class="lineno"> 2624</span>} <span class="comment">// namespace ipc::session</span></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html">ipc::session::Client_session_impl</a></div><div class="ttdoc">Internal, non-movable pImpl-lite implementation of Client_session_mv class template.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00217">client_session_impl.hpp:220</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a0edcc39889b5f68492eb9156dc7a9b7a"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a0edcc39889b5f68492eb9156dc7a9b7a">ipc::session::Client_session_impl::Client_session_impl</a></div><div class="ttdeci">Client_session_impl(flow::log::Logger *logger_ptr, const Client_app &amp;cli_app_ref, const Server_app &amp;srv_app_ref, Task_err &amp;&amp;on_err_func)</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00953">client_session_impl.hpp:953</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a139fde1cf8dc2c64276b9eb25b35bcee"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a139fde1cf8dc2c64276b9eb25b35bcee">ipc::session::Client_session_impl::on_master_channel_log_in_rsp</a></div><div class="ttdeci">void on_master_channel_log_in_rsp(typename Master_structured_channel::Msg_in_ptr &amp;&amp;log_in_rsp, Channels *init_channels_by_cli_req_pre_sized, Mdt_reader_ptr *mdt_from_srv_or_null, Channels *init_channels_by_srv_req)</div><div class="ttdoc">In thread W, handler for the successful receipt of log-in response (upon send()ing the log-in request...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01536">client_session_impl.hpp:1537</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a1a7560109fa2aa2c16d4f4159918e2c2"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a1a7560109fa2aa2c16d4f4159918e2c2">ipc::session::Client_session_impl::sync_connect_impl</a></div><div class="ttdeci">bool sync_connect_impl(Error_code *err_code, Function&lt; bool(flow::async::Task_asio_err &amp;&amp;)&gt; *async_connect_impl_func)</div><div class="ttdoc">Utility for *this and sub-classes: Implements sync_connect() given a functor that invokes the calling...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01101">client_session_impl.hpp:1101</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a1b34618ce1160871a4b16f4ecc3e86e6"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a1b34618ce1160871a4b16f4ecc3e86e6">ipc::session::Client_session_impl::S_SHM_TYPE</a></div><div class="ttdeci">static constexpr schema::ShmType S_SHM_TYPE</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00260">client_session_impl.hpp:260</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a20f1ea81df379ff8153ba14f56b7f035"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a20f1ea81df379ff8153ba14f56b7f035">ipc::session::Client_session_impl::S_SHM_ENABLED</a></div><div class="ttdeci">static constexpr bool S_SHM_ENABLED</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00263">client_session_impl.hpp:263</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a313e2fc3d4017232bad4fac2baae20a4"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a313e2fc3d4017232bad4fac2baae20a4">ipc::session::Client_session_impl::complete_async_connect_after_canceling_peer_state</a></div><div class="ttdeci">void complete_async_connect_after_canceling_peer_state(const Error_code &amp;err_code_or_success)</div><div class="ttdoc">Utility for sub-classes: to be invoked, only from thread W and asynchronously at that,...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02557">client_session_impl.hpp:2557</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a3a5f5102020adace1e898d977e929908"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a3a5f5102020adace1e898d977e929908">ipc::session::Client_session_impl::m_state</a></div><div class="ttdeci">State m_state</div><div class="ttdoc">The current state of *this.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00804">client_session_impl.hpp:804</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a3acf3432c3806476fc20e951d0790949"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a3acf3432c3806476fc20e951d0790949">ipc::session::Client_session_impl::m_master_channel</a></div><div class="ttdeci">Master_structured_channel_ptr m_master_channel</div><div class="ttdoc">The session master channel.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00876">client_session_impl.hpp:876</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a3c53046a113fcf1ba4c857e8d4c2fbbd"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a3c53046a113fcf1ba4c857e8d4c2fbbd">ipc::session::Client_session_impl::m_protocol_negotiator_aux</a></div><div class="ttdeci">transport::Protocol_negotiator m_protocol_negotiator_aux</div><div class="ttdoc">Analogous to m_protocol_negotiator but pertains to algorithms perpetuated by (if relevant) non-vanill...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00825">client_session_impl.hpp:825</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a4036fbd01410a9befc7c541368d92704"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a4036fbd01410a9befc7c541368d92704">ipc::session::Client_session_impl::S_MQS_ENABLED</a></div><div class="ttdeci">static constexpr bool S_MQS_ENABLED</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00266">client_session_impl.hpp:266</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a417e9c40eefdfb4622f84275795640c4"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a417e9c40eefdfb4622f84275795640c4">ipc::session::Client_session_impl::on_master_channel_error</a></div><div class="ttdeci">void on_master_channel_error(const Master_structured_channel_observer &amp;master_channel_observer, const Error_code &amp;err_code)</div><div class="ttdoc">In thread W, handler for m_master_channel indicating incoming-direction channel-hosing error.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01955">client_session_impl.hpp:1956</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a428ae010a09aae1bac509e87fd927152"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a428ae010a09aae1bac509e87fd927152">ipc::session::Client_session_impl::invoke_conn_on_done_func</a></div><div class="ttdeci">void invoke_conn_on_done_func(const Error_code &amp;err_code)</div><div class="ttdoc">Little helper that invokes m_conn_on_done_func_or_empty, passing it err_code, and – per that member's...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01940">client_session_impl.hpp:1940</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a43d56aeae47d1fa815178ebd0ae1ff48"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a43d56aeae47d1fa815178ebd0ae1ff48">ipc::session::Client_session_impl::cancel_peer_state_to_null</a></div><div class="ttdeci">void cancel_peer_state_to_null()</div><div class="ttdoc">Utility for sub-classes: executed from async_connect()'s on_done_func(Error_code()) (i....</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02519">client_session_impl.hpp:2519</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a4a377590fbf55b6d312f24d888d2a1bd"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a4a377590fbf55b6d312f24d888d2a1bd">ipc::session::Client_session_impl::open_channel</a></div><div class="ttdeci">bool open_channel(Channel_obj *target_channel, const Mdt_builder_ptr &amp;mdt, Error_code *err_code)</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02114">client_session_impl.hpp:2114</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a4c62a381340b0f494c4f117960bfca2b"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a4c62a381340b0f494c4f117960bfca2b">ipc::session::Client_session_impl::Master_structured_channel</a></div><div class="ttdeci">typename Base::Master_structured_channel Master_structured_channel</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00390">client_session_impl.hpp:390</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a56c0d2b0ff082d1f7b0738e2528b4a92"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a56c0d2b0ff082d1f7b0738e2528b4a92">ipc::session::Client_session_impl::async_connect</a></div><div class="ttdeci">bool async_connect(const Mdt_builder_ptr &amp;mdt, Channels *init_channels_by_cli_req_pre_sized, Mdt_reader_ptr *mdt_from_srv_or_null, Channels *init_channels_by_srv_req, Task_err &amp;&amp;on_done_func)</div><div class="ttdoc">Core implementation of sync_connect().</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01136">client_session_impl.hpp:1136</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a5f156b23ce19cd878c3e83330e63f56f"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a5f156b23ce19cd878c3e83330e63f56f">ipc::session::Client_session_impl::master_channel_const</a></div><div class="ttdeci">const Master_structured_channel &amp; master_channel_const() const</div><div class="ttdoc">Utility for sub-classes: provides ability to immutably query the session master channel,...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02597">client_session_impl.hpp:2597</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a65fe6d3d227016858428a170db961cc7"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a65fe6d3d227016858428a170db961cc7">ipc::session::Client_session_impl::S_GRACEFUL_FINISH_REQUIRED</a></div><div class="ttdeci">static constexpr bool S_GRACEFUL_FINISH_REQUIRED</div><div class="ttdoc">Short-hand for template parameter knob S_GRACEFUL_FINISH_REQUIRED_V: see class template doc header.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00272">client_session_impl.hpp:272</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a6a1cb9c344c312b4eff5c360d7114e2c"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a6a1cb9c344c312b4eff5c360d7114e2c">ipc::session::Client_session_impl::Master_structured_channel_observer</a></div><div class="ttdeci">typename Base::Master_structured_channel_observer Master_structured_channel_observer</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00539">client_session_impl.hpp:539</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a6c67f6c993089dadf16acb47d535cb68"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a6c67f6c993089dadf16acb47d535cb68">ipc::session::Client_session_impl::create_channel_obj</a></div><div class="ttdeci">void create_channel_obj(const Shared_name &amp;mq_name_c2s_or_none, const Shared_name &amp;mq_name_s2c_or_none, util::Native_handle &amp;&amp;local_hndl_or_null, Channel_obj *opened_channel_ptr, bool active_else_passive, Error_code *err_code_ptr)</div><div class="ttdoc">In thread W, based on resources acquired on server side, creates local Channel_obj to emit to the use...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02405">client_session_impl.hpp:2405</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a7ecad909e1013271ff365437f2fdae85"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a7ecad909e1013271ff365437f2fdae85">ipc::session::Client_session_impl::mdt_builder</a></div><div class="ttdeci">Mdt_builder_ptr mdt_builder() const</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02061">client_session_impl.hpp:2061</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a84bcd253bb1cd89fcf94233c2f771142"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a84bcd253bb1cd89fcf94233c2f771142">ipc::session::Client_session_impl::on_master_channel_open_channel_req</a></div><div class="ttdeci">void on_master_channel_open_channel_req(typename Master_structured_channel::Msg_in_ptr &amp;&amp;open_channel_req)</div><div class="ttdoc">In thread W, handler for m_master_channel receiving a passive-open (a/k/a open-channel-to-client) req...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02286">client_session_impl.hpp:2287</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a89d1ce46faa61df455b6f186eb892711"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a89d1ce46faa61df455b6f186eb892711">ipc::session::Client_session_impl::m_last_passively_opened_channel_id</a></div><div class="ttdeci">unsigned int m_last_passively_opened_channel_id</div><div class="ttdoc">A-la m_last_actively_opened_channel_id but for passively-opened channels (on_master_channel_open_chan...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00841">client_session_impl.hpp:841</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a8fe80ed65e416a2d1fcadb045dac0fcf"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a8fe80ed65e416a2d1fcadb045dac0fcf">ipc::session::Client_session_impl::Client_session_impl</a></div><div class="ttdeci">Client_session_impl(flow::log::Logger *logger_ptr, const Client_app &amp;cli_app_ref, const Server_app &amp;srv_app_ref, Task_err &amp;&amp;on_err_func, On_passive_open_channel_handler &amp;&amp;on_passive_open_channel_func)</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00940">client_session_impl.hpp:940</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a95c690ae89ac5e4017dd2ac030703dae"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a95c690ae89ac5e4017dd2ac030703dae">ipc::session::Client_session_impl::Structured_msg_builder_config</a></div><div class="ttdeci">typename Base::Structured_msg_builder_config Structured_msg_builder_config</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00249">client_session_impl.hpp:249</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a994a2f0b281fdeaeb6c09f6d91df351a"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a994a2f0b281fdeaeb6c09f6d91df351a">ipc::session::Client_session_impl::Channel_obj</a></div><div class="ttdeci">typename Base::Channel_obj Channel_obj</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00231">client_session_impl.hpp:231</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_a9d93e6080abf3b0827b97e084f5e8356"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#a9d93e6080abf3b0827b97e084f5e8356">ipc::session::Client_session_impl::Mdt_builder_ptr</a></div><div class="ttdeci">typename Base::Mdt_builder_ptr Mdt_builder_ptr</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00246">client_session_impl.hpp:246</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_aa12539a1a446cffb097f70cba8166088"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#aa12539a1a446cffb097f70cba8166088">ipc::session::Client_session_impl::~Client_session_impl</a></div><div class="ttdeci">~Client_session_impl()</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01051">client_session_impl.hpp:1051</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_aa4a518c48b0611e13ad4982d067674f7"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#aa4a518c48b0611e13ad4982d067674f7">ipc::session::Client_session_impl::Persistent_mq_handle_from_cfg</a></div><div class="ttdeci">typename Base::Persistent_mq_handle_from_cfg Persistent_mq_handle_from_cfg</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00542">client_session_impl.hpp:542</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_aa60d7f50f9a9bec95c627778f1556be0"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#aa60d7f50f9a9bec95c627778f1556be0">ipc::session::Client_session_impl::sync_connect</a></div><div class="ttdeci">bool sync_connect(const Mdt_builder_ptr &amp;mdt, Channels *init_channels_by_cli_req_pre_sized, Mdt_reader_ptr *mdt_from_srv_or_null, Channels *init_channels_by_srv_req, Error_code *err_code)</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01077">client_session_impl.hpp:1077</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_aab1b23e3370a77db375a50ab156b5662"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#aab1b23e3370a77db375a50ab156b5662">ipc::session::Client_session_impl::Channels</a></div><div class="ttdeci">typename Base::Channels Channels</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00234">client_session_impl.hpp:234</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_aad9a5e95ffde170a6483b74f397d9169"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#aad9a5e95ffde170a6483b74f397d9169">ipc::session::Client_session_impl::session_token</a></div><div class="ttdeci">const Session_token &amp; session_token() const</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02023">client_session_impl.hpp:2023</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_aaf622f5f111ffa95d4ec6c636cfddb4a"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#aaf622f5f111ffa95d4ec6c636cfddb4a">ipc::session::Client_session_impl::sync_connect</a></div><div class="ttdeci">bool sync_connect(Error_code *err_code)</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01071">client_session_impl.hpp:1071</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ab55fdca2097f5444f35efc97a8af326b"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ab55fdca2097f5444f35efc97a8af326b">ipc::session::Client_session_impl::m_protocol_negotiator</a></div><div class="ttdeci">transport::Protocol_negotiator m_protocol_negotiator</div><div class="ttdoc">Handles the protocol negotiation at the start of the pipe, as pertains to algorithms perpetuated by t...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00815">client_session_impl.hpp:815</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ab792f2389fd035827ae8dbead1650b78"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ab792f2389fd035827ae8dbead1650b78">ipc::session::Client_session_impl::async_worker</a></div><div class="ttdeci">flow::async::Single_thread_task_loop * async_worker()</div><div class="ttdoc">Utility for sub-classes: provides ability to schedule or post tasks onto thread W.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02591">client_session_impl.hpp:2591</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_abba4e0890f2d40b0f0cd76ecface739f"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#abba4e0890f2d40b0f0cd76ecface739f">ipc::session::Client_session_impl::m_graceful_finisher</a></div><div class="ttdeci">std::optional&lt; typename Base::Graceful_finisher &gt; m_graceful_finisher</div><div class="ttdoc">Null until PEER state is reached, and NULL unless compile-time S_GRACEFUL_FINISH_REQUIRED is true,...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00884">client_session_impl.hpp:884</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_abe6c733821534ec020b7cec02cfc3e66"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#abe6c733821534ec020b7cec02cfc3e66">ipc::session::Client_session_impl::Master_channel_req_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; Master_channel_req &gt; Master_channel_req_ptr</div><div class="ttdoc">Short-hand for ref-counted pointer to Master_channel_req.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00618">client_session_impl.hpp:618</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ac28652995339005a7afeb467b33b3b62"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ac28652995339005a7afeb467b33b3b62">ipc::session::Client_session_impl::S_SOCKET_STREAM_ENABLED</a></div><div class="ttdeci">static constexpr bool S_SOCKET_STREAM_ENABLED</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00269">client_session_impl.hpp:269</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ac3039c565e1da99296dfb71255129201"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ac3039c565e1da99296dfb71255129201">ipc::session::Client_session_impl::m_async_worker</a></div><div class="ttdeci">flow::async::Single_thread_task_loop m_async_worker</div><div class="ttdoc">Worker thread (a/k/a thread W).</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00853">client_session_impl.hpp:853</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ac983066e433f143cf02cd730260e6e65"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ac983066e433f143cf02cd730260e6e65">ipc::session::Client_session_impl::on_master_channel_init_open_channel</a></div><div class="ttdeci">void on_master_channel_init_open_channel(typename Master_structured_channel::Msg_in_ptr &amp;&amp;open_channel_msg, size_t n_init_channels, const boost::shared_ptr&lt; Channels &gt; &amp;init_channels_ptr, Channels *init_channels_by_cli_req_pre_sized, Mdt_reader_ptr *mdt_from_srv_or_null, Channels *init_channels_by_srv_req, Mdt_reader_ptr &amp;&amp;mdt_from_srv)</div><div class="ttdoc">In thread W, handler for m_master_channel receiving a init-channel-open message.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l01779">client_session_impl.hpp:1780</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_acaca4c5b8e56cf4cd29b5cc886993ded"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#acaca4c5b8e56cf4cd29b5cc886993ded">ipc::session::Client_session_impl::open_channel</a></div><div class="ttdeci">bool open_channel(Channel_obj *target_channel, Error_code *err_code)</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02279">client_session_impl.hpp:2279</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_acd9519f313206fdd2cd6ca91efb79516"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#acd9519f313206fdd2cd6ca91efb79516">ipc::session::Client_session_impl::Base</a></div><div class="ttdeci">Session_base&lt; S_MQ_TYPE_OR_NONE, S_TRANSMIT_NATIVE_HANDLES, Mdt_payload &gt; Base</div><div class="ttdoc">Short-hand for base type.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00225">client_session_impl.hpp:225</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ad0ad69f676fc1260a3c493781fbbb81d"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ad0ad69f676fc1260a3c493781fbbb81d">ipc::session::Client_session_impl::Mdt_reader_ptr</a></div><div class="ttdeci">typename Base::Mdt_reader_ptr Mdt_reader_ptr</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00240">client_session_impl.hpp:240</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ad432ab4e95ddcfd0396d5ea821dec15c"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ad432ab4e95ddcfd0396d5ea821dec15c">ipc::session::Client_session_impl::Master_structured_channel_ptr</a></div><div class="ttdeci">typename Base::Master_structured_channel_ptr Master_structured_channel_ptr</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00536">client_session_impl.hpp:536</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ad5a3539f5e10933ff4abc7cde1056798"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ad5a3539f5e10933ff4abc7cde1056798">ipc::session::Client_session_impl::Mdt_builder</a></div><div class="ttdeci">typename Base::Mdt_builder Mdt_builder</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00243">client_session_impl.hpp:243</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ad6624a4b1f7fd6e24bdde50b323b8f97"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ad6624a4b1f7fd6e24bdde50b323b8f97">ipc::session::Client_session_impl::On_passive_open_channel_func</a></div><div class="ttdeci">typename Base::On_passive_open_channel_func On_passive_open_channel_func</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00545">client_session_impl.hpp:545</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_adac4cba3aefa629566f182a240b4cedd"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#adac4cba3aefa629566f182a240b4cedd">ipc::session::Client_session_impl::cancel_peer_state_to_connecting</a></div><div class="ttdeci">Master_structured_channel * cancel_peer_state_to_connecting(Task_err &amp;&amp;on_done_func)</div><div class="ttdoc">Utility for sub-classes: executed from async_connect()'s on_done_func(Error_code()) (i....</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l02538">client_session_impl.hpp:2538</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_addb0e40c34f2ae44ee1252f8123c149c"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#addb0e40c34f2ae44ee1252f8123c149c">ipc::session::Client_session_impl::m_conn_on_done_func_or_empty</a></div><div class="ttdeci">flow::async::Task_asio_err m_conn_on_done_func_or_empty</div><div class="ttdoc">The on_done_func argument to async_connect(); .empty() except while in State::S_CONNECTING state.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00832">client_session_impl.hpp:832</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ade1b57a26147ececddbd0234c0b63be9"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ade1b57a26147ececddbd0234c0b63be9">ipc::session::Client_session_impl::m_last_actively_opened_channel_id</a></div><div class="ttdeci">unsigned int m_last_actively_opened_channel_id</div><div class="ttdoc">Logging-only *this-unique ID used in nicknaming the last actively-opened (via open_channel()) channel...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00838">client_session_impl.hpp:838</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ae457d7b16843699006feb43e1073296a"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ae457d7b16843699006feb43e1073296a">ipc::session::Client_session_impl::Mdt_payload_obj</a></div><div class="ttdeci">typename Base::Mdt_payload_obj Mdt_payload_obj</div><div class="ttdoc">See Client_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00237">client_session_impl.hpp:237</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_ae82914b6c13a8ff1b8ad9b2b179d4d74"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#ae82914b6c13a8ff1b8ad9b2b179d4d74">ipc::session::Client_session_impl::Structured_msg_reader_config</a></div><div class="ttdeci">typename Base::Structured_msg_reader_config Structured_msg_reader_config</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00252">client_session_impl.hpp:252</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_aeaf64876702dffaab7441e3006195134"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#aeaf64876702dffaab7441e3006195134">ipc::session::Client_session_impl::Client_session_impl</a></div><div class="ttdeci">Client_session_impl(flow::log::Logger *logger_ptr, const Client_app &amp;cli_app_ref, const Server_app &amp;srv_app_ref, flow::async::Task_asio_err &amp;&amp;on_err_func, On_passive_open_channel_func &amp;&amp;on_passive_open_channel_func_or_empty_arg, std::nullptr_t tag)</div><div class="ttdoc">Delegated-to ctor that implements both non-default public ctors.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00901">client_session_impl.hpp:901</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_af7a951bd266bdd0e3339a0fbddba9e8b"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#af7a951bd266bdd0e3339a0fbddba9e8b">ipc::session::Client_session_impl::State</a></div><div class="ttdeci">State</div><div class="ttdoc">Overall state of a Client_session_impl.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00548">client_session_impl.hpp:549</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Client__session__impl_html_afb09c3a23b7e63938b9a494cec6e769b"><div class="ttname"><a href="classipc_1_1session_1_1Client__session__impl.html#afb09c3a23b7e63938b9a494cec6e769b">ipc::session::Client_session_impl::dtor_async_worker_stop</a></div><div class="ttdeci">void dtor_async_worker_stop()</div><div class="ttdoc">Synchronously stops async_worker() loop, the post-condition being that thread W has been joined; no t...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00964">client_session_impl.hpp:964</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_1_1Graceful__finisher_html"><div class="ttname"><a href="classipc_1_1session_1_1Session__base_1_1Graceful__finisher.html">ipc::session::Session_base::Graceful_finisher</a></div><div class="ttdoc">Optional to use by subclasses, this operates a simple state machine that carries out a graceful-sessi...</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00575">session_base.hpp:578</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_1_1Graceful__finisher_html_af441f45ce1ed7b890c3ab77d959f8830"><div class="ttname"><a href="classipc_1_1session_1_1Session__base_1_1Graceful__finisher.html#af441f45ce1ed7b890c3ab77d959f8830">ipc::session::Session_base::Graceful_finisher::on_dtor_start</a></div><div class="ttdeci">void on_dtor_start()</div><div class="ttdoc">The reason Graceful_finisher exists, this method must be called at the start of *_session_impl dtor; ...</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l01126">session_base.hpp:1126</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html">ipc::session::Session_base</a></div><div class="ttdoc">Internal type containing data and types common to internal types Server_session_impl and Client_sessi...</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00067">session_base.hpp:69</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a1f7c4243c8bd55930f51a568884c8aaf"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a1f7c4243c8bd55930f51a568884c8aaf">ipc::session::Session_base::S_SOCKET_STREAM_ENABLED</a></div><div class="ttdeci">static constexpr bool S_SOCKET_STREAM_ENABLED</div><div class="ttdoc">See Session_mv.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00077">session_base.hpp:77</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a26d038e14e3c0e461e76de88c4ce76c5"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a26d038e14e3c0e461e76de88c4ce76c5">ipc::session::Session_base::Master_structured_channel</a></div><div class="ttdeci">transport::struc::Channel_via_heap&lt; transport::Socket_stream_channel&lt; true &gt;, schema::detail::SessionMasterChannelMessageBody&lt; Mdt_payload_obj &gt; &gt; Master_structured_channel</div><div class="ttdoc">The (internally used) session master channel is a transport::struc::Channel of this concrete type.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00352">session_base.hpp:355</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a27a5731a648effb6b4b42f0312affa74"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a27a5731a648effb6b4b42f0312affa74">ipc::session::Session_base::S_MQS_ENABLED</a></div><div class="ttdeci">static constexpr bool S_MQS_ENABLED</div><div class="ttdoc">See Session_mv.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00074">session_base.hpp:74</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a35234981ca87cc2f6b118b3e52452ea8"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a35234981ca87cc2f6b118b3e52452ea8">ipc::session::Session_base::Mdt_payload_obj</a></div><div class="ttdeci">Mdt_payload Mdt_payload_obj</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00125">session_base.hpp:125</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a3c0824a54ef32915c5c5ea76481f2409"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a3c0824a54ef32915c5c5ea76481f2409">ipc::session::Session_base::On_passive_open_channel_func</a></div><div class="ttdeci">Function&lt; void(Channel_obj &amp;&amp;new_channel, Mdt_reader_ptr &amp;&amp;new_channel_mdt)&gt; On_passive_open_channel_func</div><div class="ttdoc">Concrete function type for the on-passive-open handler (if any), used for storage.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00372">session_base.hpp:373</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a4a7a5b83f6ba8bd505685636eabc012b"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">ipc::session::Session_base::Mdt_builder_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; Mdt_builder &gt; Mdt_builder_ptr</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00136">session_base.hpp:136</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a638232ef74a0eb80aeb4f027ee06f9bf"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">ipc::session::Session_base::Channels</a></div><div class="ttdeci">std::vector&lt; Channel_obj &gt; Channels</div><div class="ttdoc">See Session_mv. Note: If changed from vector please update those doc headers too.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00122">session_base.hpp:122</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a71f02a809d667c23ff8af29a96940bd1"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">ipc::session::Session_base::Channel_obj</a></div><div class="ttdeci">std::conditional_t&lt; S_MQS_ENABLED, std::conditional_t&lt; S_TRANSMIT_NATIVE_HANDLES, transport::Mqs_socket_stream_channel&lt; true, Persistent_mq_handle_from_cfg &gt;, transport::Mqs_channel&lt; true, Persistent_mq_handle_from_cfg &gt; &gt;, std::conditional_t&lt; S_TRANSMIT_NATIVE_HANDLES, transport::Socket_stream_channel&lt; true &gt;, transport::Socket_stream_channel_of_blobs&lt; true &gt; &gt; &gt; Channel_obj</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00111">session_base.hpp:119</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a7d68bbb8c0c09983619d563bca30bd45"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a7d68bbb8c0c09983619d563bca30bd45">ipc::session::Session_base::Mdt_builder</a></div><div class="ttdeci">typename transport::struc::schema::Metadata&lt; Mdt_payload_obj &gt;::Builder Mdt_builder</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00132">session_base.hpp:133</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a848c0f5247644ada0f8b0ab816eedda8"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a848c0f5247644ada0f8b0ab816eedda8">ipc::session::Session_base::Persistent_mq_handle_from_cfg</a></div><div class="ttdeci">std::conditional_t&lt;!S_MQS_ENABLED, transport::Null_peer, std::conditional_t&lt; S_MQ_TYPE_OR_NONE==schema::MqType::POSIX, transport::Posix_mq_handle, transport::Bipc_mq_handle &gt; &gt; Persistent_mq_handle_from_cfg</div><div class="ttdoc">Relevant only if S_MQS_ENABLED, this is the Persistent_mq_handle-concept impl type specified by the u...</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00103">session_base.hpp:108</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_abd854f2b9316361ef18f15610c242d4b"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#abd854f2b9316361ef18f15610c242d4b">ipc::session::Session_base::Structured_msg_reader_config</a></div><div class="ttdeci">transport::struc::Heap_reader::Config Structured_msg_reader_config</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00142">session_base.hpp:142</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_ace4dab42adec6354cc66081dd218ac71"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">ipc::session::Session_base::Mdt_reader_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; typename transport::struc::schema::Metadata&lt; Mdt_payload_obj &gt;::Reader &gt; Mdt_reader_ptr</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00128">session_base.hpp:129</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_ae2a123b29dd044a638e94d1f294c8f28"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#ae2a123b29dd044a638e94d1f294c8f28">ipc::session::Session_base::Master_structured_channel_observer</a></div><div class="ttdeci">boost::weak_ptr&lt; Master_structured_channel &gt; Master_structured_channel_observer</div><div class="ttdoc">Observer of Master_structured_channel_ptr. See its doc header.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00369">session_base.hpp:369</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_aee0db48505c84d3553b7110a9a815036"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#aee0db48505c84d3553b7110a9a815036">ipc::session::Session_base::Structured_msg_builder_config</a></div><div class="ttdeci">transport::struc::Heap_fixed_builder::Config Structured_msg_builder_config</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00139">session_base.hpp:139</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_af0ca2a01d7d0d92038aae56fc1cdd505"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#af0ca2a01d7d0d92038aae56fc1cdd505">ipc::session::Session_base::Master_structured_channel_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; Master_structured_channel &gt; Master_structured_channel_ptr</div><div class="ttdoc">Handle to Master_structured_channel.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00366">session_base.hpp:366</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Mqs__channel_html"><div class="ttname"><a href="classipc_1_1transport_1_1Mqs__channel.html">ipc::transport::Mqs_channel</a></div><div class="ttdoc">A Channel with at least a blobs pipe consisting of two MQs of type Persistent_mq_handle (template arg...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l01174">channel.hpp:1180</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Mqs__socket__stream__channel_html"><div class="ttname"><a href="classipc_1_1transport_1_1Mqs__socket__stream__channel.html">ipc::transport::Mqs_socket_stream_channel</a></div><div class="ttdoc">A Channel with a blobs pipe consisting of 2 MQs of type Persistent_mq_handle (template arg); and a ha...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l01273">channel.hpp:1278</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Protocol__negotiator_html"><div class="ttname"><a href="classipc_1_1transport_1_1Protocol__negotiator.html">ipc::transport::Protocol_negotiator</a></div><div class="ttdoc">A simple state machine that, assuming the opposide side of a comm pathway uses an equivalent state ma...</div><div class="ttdef"><b>Definition:</b> <a href="protocol__negotiator_8hpp_source.html#l00189">protocol_negotiator.hpp:191</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Socket__stream__channel__of__blobs_html"><div class="ttname"><a href="classipc_1_1transport_1_1Socket__stream__channel__of__blobs.html">ipc::transport::Socket_stream_channel_of_blobs</a></div><div class="ttdoc">A Channel with a blobs pipe only (no handles pipe) that uses a Unix domain socket connection as the u...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l01093">channel.hpp:1097</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Socket__stream__channel_html"><div class="ttname"><a href="classipc_1_1transport_1_1Socket__stream__channel.html">ipc::transport::Socket_stream_channel</a></div><div class="ttdoc">A Channel with a handles pipe only (no blobs pipe) that uses a Unix domain socket connection as the u...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l01025">channel.hpp:1029</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Socket__stream__channel_html_acad7936d9a7db817bc46ee4fe479d838"><div class="ttname"><a href="classipc_1_1transport_1_1Socket__stream__channel.html#acad7936d9a7db817bc46ee4fe479d838">ipc::transport::Socket_stream_channel::remote_peer_process_credentials</a></div><div class="ttdeci">util::Process_credentials remote_peer_process_credentials(Error_code *err_code=0) const</div><div class="ttdoc">Identical to Native_socket_stream::remote_peer_process_credentials(): OS-reported process credential ...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l02211">channel.hpp:2211</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1struc_1_1Channel__base_html_ab0eb05b5fb52364c99868a8535aaf26e"><div class="ttname"><a href="classipc_1_1transport_1_1struc_1_1Channel__base.html#ab0eb05b5fb52364c99868a8535aaf26e">ipc::transport::struc::Channel_base::S_SERIALIZE_VIA_HEAP</a></div><div class="ttdeci">static constexpr Serialize_via_heap S_SERIALIZE_VIA_HEAP</div><div class="ttdoc">The sole value of the tag type Serialize_via_heap.</div><div class="ttdef"><b>Definition:</b> <a href="channel__base_8hpp_source.html#l00157">channel_base.hpp:157</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1struc_1_1Channel_html"><div class="ttname"><a href="classipc_1_1transport_1_1struc_1_1Channel.html">ipc::transport::struc::Channel</a></div><div class="ttdoc">Owning and wrapping a pre-connected transport::Channel peer (an endpoint of an established channel ov...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__transport__structured_2src_2ipc_2transport_2struc_2channel_8hpp_source.html#l00580">channel.hpp:583</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1struc_1_1Channel_html_ae1f4b316eaeb7ed520a84d9e21e21063"><div class="ttname"><a href="classipc_1_1transport_1_1struc_1_1Channel.html#ae1f4b316eaeb7ed520a84d9e21e21063">ipc::transport::struc::Channel::Msg_in_ptr</a></div><div class="ttdeci">typename Sync_io_obj::Msg_in_ptr Msg_in_ptr</div><div class="ttdoc">A ref-counted handle to Msg_in.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__transport__structured_2src_2ipc_2transport_2struc_2channel_8hpp_source.html#l00640">channel.hpp:640</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1sync__io_1_1Native__socket__stream_html"><div class="ttname"><a href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">ipc::transport::sync_io::Native_socket_stream</a></div><div class="ttdoc">Implements both sync_io::Native_handle_sender and sync_io::Native_handle_receiver concepts by using a...</div><div class="ttdef"><b>Definition:</b> <a href="sync__io_2native__socket__stream_8hpp_source.html#l00150">native_socket_stream.hpp:151</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1sync__io_1_1Native__socket__stream_html_a00624e2fc3757012d13e3dc0feb26a21"><div class="ttname"><a href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html#a00624e2fc3757012d13e3dc0feb26a21">ipc::transport::sync_io::Native_socket_stream::S_MAX_META_BLOB_LENGTH</a></div><div class="ttdeci">static const size_t &amp; S_MAX_META_BLOB_LENGTH</div><div class="ttdoc">The maximum length of a blob that can be sent by this protocol.</div><div class="ttdef"><b>Definition:</b> <a href="sync__io_2native__socket__stream_8hpp_source.html#l00197">native_socket_stream.hpp:197</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1sync__io_1_1Native__socket__stream_html_a2e22d55369f5bd67a4e0d277b73f2823"><div class="ttname"><a href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html#a2e22d55369f5bd67a4e0d277b73f2823">ipc::transport::sync_io::Native_socket_stream::sync_connect</a></div><div class="ttdeci">bool sync_connect(const Shared_name &amp;absolute_name, Error_code *err_code=0)</div><div class="ttdoc">Identical to Async_io_obj counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="sync__io_2native__socket__stream_8cpp_source.html#l00083">native_socket_stream.cpp:83</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Process__credentials_html_a18c901aeeed11c91afcc6379260f02a5"><div class="ttname"><a href="classipc_1_1util_1_1Process__credentials.html#a18c901aeeed11c91afcc6379260f02a5">ipc::util::Process_credentials::own_process_id</a></div><div class="ttdeci">static process_id_t own_process_id()</div><div class="ttdoc">Obtains the calling process's process_id().</div><div class="ttdef"><b>Definition:</b> <a href="process__credentials_8cpp_source.html#l00126">process_credentials.cpp:126</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Process__credentials_html_a9a14d2788f0aaf91042206d5f6e5cabd"><div class="ttname"><a href="classipc_1_1util_1_1Process__credentials.html#a9a14d2788f0aaf91042206d5f6e5cabd">ipc::util::Process_credentials::own_user_id</a></div><div class="ttdeci">static user_id_t own_user_id()</div><div class="ttdoc">Obtains the calling process's effective user_id().</div><div class="ttdef"><b>Definition:</b> <a href="process__credentials_8cpp_source.html#l00131">process_credentials.cpp:131</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Process__credentials_html_a9c4074f11192a1193afb019d04753cd2"><div class="ttname"><a href="classipc_1_1util_1_1Process__credentials.html#a9c4074f11192a1193afb019d04753cd2">ipc::util::Process_credentials::own_group_id</a></div><div class="ttdeci">static group_id_t own_group_id()</div><div class="ttdoc">Obtains the calling process's effective group_id().</div><div class="ttdef"><b>Definition:</b> <a href="process__credentials_8cpp_source.html#l00136">process_credentials.cpp:136</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Shared__name_html"><div class="ttname"><a href="classipc_1_1util_1_1Shared__name.html">ipc::util::Shared_name</a></div><div class="ttdoc">String-wrapping abstraction representing a name uniquely distinguishing a kernel-persistent entity fr...</div><div class="ttdef"><b>Definition:</b> <a href="shared__name_8hpp_source.html#l00241">shared_name.hpp:242</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Shared__name_html_a43205a00865429c1bef6c7896816bf5c"><div class="ttname"><a href="classipc_1_1util_1_1Shared__name.html#a43205a00865429c1bef6c7896816bf5c">ipc::util::Shared_name::S_SENTINEL</a></div><div class="ttdeci">static const Shared_name S_SENTINEL</div><div class="ttdoc">A Shared_name fragment, with no S_SEPARATOR characters inside, that represents a path component that ...</div><div class="ttdef"><b>Definition:</b> <a href="shared__name_8hpp_source.html#l00280">shared_name.hpp:280</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Shared__name_html_a48f20b7b54490aa10dc64081d34c55b2"><div class="ttname"><a href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">ipc::util::Shared_name::ct</a></div><div class="ttdeci">static Shared_name ct(const Source &amp;src)</div><div class="ttdoc">Copy-constructs from a char-sequence container (including string, util::String_view,...</div><div class="ttdef"><b>Definition:</b> <a href="shared__name_8hpp_source.html#l00674">shared_name.hpp:674</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Shared__name_html_a861ea6c9ad6672e83bab5c7747b66f7b"><div class="ttname"><a href="classipc_1_1util_1_1Shared__name.html#a861ea6c9ad6672e83bab5c7747b66f7b">ipc::util::Shared_name::empty</a></div><div class="ttdeci">bool empty() const</div><div class="ttdoc">Returns true if and only if str().empty() == true.</div><div class="ttdef"><b>Definition:</b> <a href="shared__name_8cpp_source.html#l00155">shared_name.cpp:155</a></div></div>
<div class="ttc" id="aipc__core_2src_2ipc_2transport_2error_8hpp_html"><div class="ttname"><a href="ipc__core_2src_2ipc_2transport_2error_8hpp.html">error.hpp</a></div></div>
<div class="ttc" id="aipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_html_a08e00c34eb0441e833ed15f23bbc7a2c"><div class="ttname"><a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a08e00c34eb0441e833ed15f23bbc7a2c">TEMPLATE_CLI_SESSION_IMPL</a></div><div class="ttdeci">#define TEMPLATE_CLI_SESSION_IMPL</div><div class="ttdoc">Internally used macro; public API users should disregard (same deal as in struc/channel....</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00892">client_session_impl.hpp:892</a></div></div>
<div class="ttc" id="aipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_html_a2442fdb91128ae6d1a2bbacc7fd03c9b"><div class="ttname"><a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp.html#a2442fdb91128ae6d1a2bbacc7fd03c9b">CLASS_CLI_SESSION_IMPL</a></div><div class="ttdeci">#define CLASS_CLI_SESSION_IMPL</div><div class="ttdoc">Internally used macro; public API users should disregard (same deal as in struc/channel....</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00896">client_session_impl.hpp:896</a></div></div>
<div class="ttc" id="aipc__session_2src_2ipc_2session_2error_8hpp_html"><div class="ttname"><a href="ipc__session_2src_2ipc_2session_2error_8hpp.html">error.hpp</a></div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa10d32cf1382fb003f09a6df2da408574"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa10d32cf1382fb003f09a6df2da408574">ipc::session::error::Code::S_SESSION_OPEN_CHANNEL_SERVER_CANNOT_PROCEED_RESOURCE_UNAVAILABLE</a></div><div class="ttdeci">@ S_SESSION_OPEN_CHANNEL_SERVER_CANNOT_PROCEED_RESOURCE_UNAVAILABLE</div><div class="ttdoc">Session channel opening: Server peer is responsible for low-level resource acquisition but failed to ...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa2c8c27c65ff6234220a84f96de8a1870"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa2c8c27c65ff6234220a84f96de8a1870">ipc::session::error::Code::S_SESSION_OPEN_CHANNEL_REMOTE_PEER_REJECTED_PASSIVE_OPEN</a></div><div class="ttdeci">@ S_SESSION_OPEN_CHANNEL_REMOTE_PEER_REJECTED_PASSIVE_OPEN</div><div class="ttdoc">Session channel opening: User code chose to reject all passive-open requests.</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa486f5607320d062fe89e559a1e7856b2"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa486f5607320d062fe89e559a1e7856b2">ipc::session::error::Code::S_CLIENT_NAMESPACE_STORE_BAD_FORMAT</a></div><div class="ttdeci">@ S_CLIENT_NAMESPACE_STORE_BAD_FORMAT</div><div class="ttdoc">Session master channel: log-in as client: The Client Namespace Store (CNS) file (a/k/a PID file) lack...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa7300721595cc25baa9a9e43bd76296aa"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa7300721595cc25baa9a9e43bd76296aa">ipc::session::error::Code::S_MUTEX_BIPC_MISC_LIBRARY_ERROR</a></div><div class="ttdeci">@ S_MUTEX_BIPC_MISC_LIBRARY_ERROR</div><div class="ttdoc">Low-level boost.ipc.mutex: boost.interprocess emitted miscellaneous library exception sans a system c...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa7d85b87223a9b277b8875c1f7971d6ad"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa7d85b87223a9b277b8875c1f7971d6ad">ipc::session::error::Code::S_SESSION_OPEN_CHANNEL_ACTIVE_TIMEOUT</a></div><div class="ttdeci">@ S_SESSION_OPEN_CHANNEL_ACTIVE_TIMEOUT</div><div class="ttdoc">Session channel opening: Other peer must reply quickly enough as-if non-blocking but did not do so in...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa866090a4d042120126722b4daf1ecc33"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa866090a4d042120126722b4daf1ecc33">ipc::session::error::Code::S_CLIENT_MASTER_LOG_IN_RESPONSE_BAD</a></div><div class="ttdeci">@ S_CLIENT_MASTER_LOG_IN_RESPONSE_BAD</div><div class="ttdoc">Session master channel: log-in as client: received log-in response is not the expected internal messa...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fac416e988563e44bf15fc6a81743eef53"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fac416e988563e44bf15fc6a81743eef53">ipc::session::error::Code::S_INVALID_ARGUMENT</a></div><div class="ttdeci">@ S_INVALID_ARGUMENT</div><div class="ttdoc">User called an API with 1 or more arguments against the API spec.</div></div>
<div class="ttc" id="anamespaceipc_1_1session_html"><div class="ttname"><a href="namespaceipc_1_1session.html">ipc::session</a></div><div class="ttdoc">Flow-IPC module providing the broad lifecycle and shared-resource organization – via the session conc...</div><div class="ttdef"><b>Definition:</b> <a href="app_8cpp_source.html#l00026">app.cpp:27</a></div></div>
<div class="ttc" id="anamespaceipc_1_1session_html_a6b2f9a90ac9cc5098d9b90e7f547c97e"><div class="ttname"><a href="namespaceipc_1_1session.html#a6b2f9a90ac9cc5098d9b90e7f547c97e">ipc::session::operator&lt;&lt;</a></div><div class="ttdeci">std::ostream &amp; operator&lt;&lt;(std::ostream &amp;os, const App &amp;val)</div><div class="ttdoc">Prints string representation of the given App to the given ostream.</div><div class="ttdef"><b>Definition:</b> <a href="app_8cpp_source.html#l00124">app.cpp:124</a></div></div>
<div class="ttc" id="anamespaceipc_1_1session_html_ade2b302f1a3623e8adc9694568d94d2c"><div class="ttname"><a href="namespaceipc_1_1session.html#ade2b302f1a3623e8adc9694568d94d2c">ipc::session::Session_token</a></div><div class="ttdeci">transport::struc::Session_token Session_token</div><div class="ttdoc">Convenience alias for the commonly used type transport::struc::Session_token.</div><div class="ttdef"><b>Definition:</b> <a href="session__fwd_8hpp_source.html#l00248">session_fwd.hpp:248</a></div></div>
<div class="ttc" id="anamespaceipc_1_1transport_1_1error_html_adfef15ef4e76cc55d652fbd9c2797297abcfca4c2347f9d377dd2ac41c41dc027"><div class="ttname"><a href="namespaceipc_1_1transport_1_1error.html#adfef15ef4e76cc55d652fbd9c2797297abcfca4c2347f9d377dd2ac41c41dc027">ipc::transport::error::Code::S_TIMEOUT</a></div><div class="ttdeci">@ S_TIMEOUT</div><div class="ttdoc">A (usually user-specified) timeout period has elapsed before a blocking operation completed.</div></div>
<div class="ttc" id="anamespaceipc_1_1transport_1_1struc_html_ad556d20a2aa2d52b83c7afb73951d47d"><div class="ttname"><a href="namespaceipc_1_1transport_1_1struc.html#ad556d20a2aa2d52b83c7afb73951d47d">ipc::transport::struc::NULL_SESSION_TOKEN</a></div><div class="ttdeci">const Session_token NULL_SESSION_TOKEN</div><div class="ttdoc">A value for which .is_nil() is true.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__transport__structured_2src_2ipc_2transport_2struc_2channel_8cpp_source.html#l00035">channel.cpp:35</a></div></div>
<div class="ttc" id="anamespaceipc_1_1transport_html_a7ee4551983d9df16ec16a3139bac50e8"><div class="ttname"><a href="namespaceipc_1_1transport.html#a7ee4551983d9df16ec16a3139bac50e8">ipc::transport::Native_handle</a></div><div class="ttdeci">util::Native_handle Native_handle</div><div class="ttdoc">Convenience alias for the commonly used type util::Native_handle.</div><div class="ttdef"><b>Definition:</b> <a href="transport__fwd_8hpp_source.html#l00081">transport_fwd.hpp:81</a></div></div>
<div class="ttc" id="anamespaceipc_1_1util_html_a0c44028a45451ebf21f6af8e806b2682"><div class="ttname"><a href="namespaceipc_1_1util.html#a0c44028a45451ebf21f6af8e806b2682">ipc::util::process_id_t</a></div><div class="ttdeci">::pid_t process_id_t</div><div class="ttdoc">Syntactic-sugary type for POSIX process ID (integer).</div><div class="ttdef"><b>Definition:</b> <a href="util__fwd_8hpp_source.html#l00143">util_fwd.hpp:143</a></div></div>
<div class="ttc" id="anamespaceipc_1_1util_html_a5664539b3d75d6d10cdfebf6eac5382d"><div class="ttname"><a href="namespaceipc_1_1util.html#a5664539b3d75d6d10cdfebf6eac5382d">ipc::util::OPEN_OR_CREATE</a></div><div class="ttdeci">const Open_or_create OPEN_OR_CREATE</div><div class="ttdoc">Tag value indicating an open-if-exists-else-create operation.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2util_2util_8cpp_source.html#l00030">util.cpp:30</a></div></div>
<div class="ttc" id="anamespaceipc_1_1util_html_a6a3a6ec85242d073df96978c63464078"><div class="ttname"><a href="namespaceipc_1_1util.html#a6a3a6ec85242d073df96978c63464078">ipc::util::OPEN_ONLY</a></div><div class="ttdeci">const Open_only OPEN_ONLY</div><div class="ttdoc">Tag value indicating an atomic open-if-exists-else-fail operation.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2util_2util_8cpp_source.html#l00031">util.cpp:31</a></div></div>
<div class="ttc" id="anamespaceipc_1_1util_html_abd43da87aa17031604c7906757c07d46"><div class="ttname"><a href="namespaceipc_1_1util.html#abd43da87aa17031604c7906757c07d46">ipc::util::op_with_possible_bipc_exception</a></div><div class="ttdeci">void op_with_possible_bipc_exception(flow::log::Logger *logger_ptr, Error_code *err_code, const Error_code &amp;misc_bipc_lib_error, String_view context, const Func &amp;func)</div><div class="ttdoc">Internal (to ipc) utility that invokes the given function that invokes a boost.interprocess operation...</div><div class="ttdef"><b>Definition:</b> <a href="util_8hpp_source.html#l00034">util.hpp:34</a></div></div>
<div class="ttc" id="anamespaceipc_1_1util_html_abda2ce5bcdbc26ca63d667b87818439c"><div class="ttname"><a href="namespaceipc_1_1util.html#abda2ce5bcdbc26ca63d667b87818439c">ipc::util::shared_resource_permissions</a></div><div class="ttdeci">Permissions shared_resource_permissions(Permissions_level permissions_lvl)</div><div class="ttdoc">Maps general Permissions_level specifier to low-level Permissions value, when the underlying resource...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2util_2util_8cpp_source.html#l00037">util.cpp:37</a></div></div>
<div class="ttc" id="anamespaceipc_html_a4ccdeed058222c635745a4dc830e99f7"><div class="ttname"><a href="namespaceipc.html#a4ccdeed058222c635745a4dc830e99f7">ipc::Log_component</a></div><div class="ttdeci">Log_component</div><div class="ttdoc">The flow::log::Component payload enumeration containing various log components used by Flow-IPC inter...</div><div class="ttdef"><b>Definition:</b> <a href="common_8hpp_source.html#l00322">common.hpp:323</a></div></div>
<div class="ttc" id="anamespaceipc_html_aa3192e586cc45d3e7c22463bf2760f89"><div class="ttname"><a href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">ipc::Error_code</a></div><div class="ttdeci">flow::Error_code Error_code</div><div class="ttdoc">Short-hand for flow::Error_code which is very common.</div><div class="ttdef"><b>Definition:</b> <a href="common_8hpp_source.html#l00298">common.hpp:298</a></div></div>
<div class="ttc" id="anamespaceipc_html_aa455c7f045059736578ca275fc1a851f"><div class="ttname"><a href="namespaceipc.html#aa455c7f045059736578ca275fc1a851f">ipc::Function</a></div><div class="ttdeci">flow::Function&lt; Signature &gt; Function</div><div class="ttdoc">Short-hand for polymorphic functor holder which is very common. This is essentially std::function.</div><div class="ttdef"><b>Definition:</b> <a href="common_8hpp_source.html#l00302">common.hpp:302</a></div></div>
<div class="ttc" id="aprotocol__negotiator_8hpp_html"><div class="ttname"><a href="protocol__negotiator_8hpp.html">protocol_negotiator.hpp</a></div></div>
<div class="ttc" id="asession__base_8hpp_html"><div class="ttname"><a href="session__base_8hpp.html">session_base.hpp</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Client__app_html"><div class="ttname"><a href="structipc_1_1session_1_1Client__app.html">ipc::session::Client_app</a></div><div class="ttdoc">An App that is used as a client in at least one client-server IPC split.</div><div class="ttdef"><b>Definition:</b> <a href="app_8hpp_source.html#l00184">app.hpp:185</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Client__session__impl_1_1Master__channel__req_html"><div class="ttname"><a href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html">ipc::session::Client_session_impl::Master_channel_req</a></div><div class="ttdoc">An open-channel/log-in request out-message.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00598">client_session_impl.hpp:599</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Client__session__impl_1_1Master__channel__req_html_a8cab22f0afe897330ad77a2bc2b536b7"><div class="ttname"><a href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html#a8cab22f0afe897330ad77a2bc2b536b7">ipc::session::Client_session_impl::Master_channel_req::m_req_msg</a></div><div class="ttdeci">Master_structured_channel::Msg_out m_req_msg</div><div class="ttdoc">The open-channel-request-to-server out-message for the session master channel (in subsequent open_cha...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00611">client_session_impl.hpp:611</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Client__session__impl_1_1Master__channel__req_html_a91c936c8824be5dfc7112a5b02fc730d"><div class="ttname"><a href="structipc_1_1session_1_1Client__session__impl_1_1Master__channel__req.html#a91c936c8824be5dfc7112a5b02fc730d">ipc::session::Client_session_impl::Master_channel_req::m_mdt_builder</a></div><div class="ttdeci">Mdt_builder_ptr::element_type m_mdt_builder</div><div class="ttdoc">The Builder m_req_msg-&gt;body_root()-&gt;getMetadata().</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2client__session__impl_8hpp_source.html#l00608">client_session_impl.hpp:608</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Server__app_html"><div class="ttname"><a href="structipc_1_1session_1_1Server__app.html">ipc::session::Server_app</a></div><div class="ttdoc">An App that is used as a server in at least one client-server IPC split.</div><div class="ttdef"><b>Definition:</b> <a href="app_8hpp_source.html#l00205">app.hpp:206</a></div></div>
<div class="ttc" id="astructipc_1_1util_1_1Native__handle_html"><div class="ttname"><a href="structipc_1_1util_1_1Native__handle.html">ipc::util::Native_handle</a></div><div class="ttdoc">A monolayer-thin wrapper around a native handle, a/k/a descriptor a/k/a FD.</div><div class="ttdef"><b>Definition:</b> <a href="native__handle_8hpp_source.html#l00062">native_handle.hpp:63</a></div></div>
<div class="ttc" id="autil_8hpp_html"><div class="ttname"><a href="util_8hpp.html">util.hpp</a></div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Fri Apr 11 2025 20:02:26 for Flow-IPC by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.4
</small></address>
</body>
</html>
